Skip to content

Create and manage work items ​

This page covers the life of a work item from the outside: getting it into Plane, copying it, and taking it out again by archiving or deleting it. To work inside a single work item, see Work item details.

Role

To create, edit, copy, and archive work items, you need the Admin or Contributor role in the project. Contributors can delete only the work items they created.

Create a work item ​

  1. Open the create modal in any of these ways:
    • Press N then I from anywhere in Plane.
    • Open a project, click Work items in the sidebar, then click Add work item at the top right.
  2. Check the project at the top left. Plane picks the project you're in, or the one you visited last.
  3. Choose a work item type if the project has more than one. The project's default type is selected.
  4. To start from a saved layout, choose a work item template. The template fills in the title, description, and properties, and you can change any of them.
  5. Enter a title. The title is required and can be up to 255 characters.
  6. Add a description and set properties such as state, priority, assignees, labels, dates, cycle, modules, estimate, and parent. If the type has custom properties, they appear below the description. Mandatory custom properties must be filled in before you can save.
  7. Click Save.

Plane creates the work item and gives it the next ID in the project, such as WEB-143. A confirmation appears at the bottom of the screen with a link to open it.

Create work item

TIP

To create several work items one after another, turn on Create more before you click Save. The modal clears and stays open for the next one.

Save a work item as a draft ​

If you close the create modal after typing something, Plane asks Save this draft?

  • Click Save to keep what you wrote in Drafts. Drafts are private to you until you move them into a project.
  • Click Discard to close the modal and lose what you wrote.
  • Click Cancel to go back to the modal.

Quick add a work item ​

Quick add creates a work item from a title alone, without opening the modal. It's the fastest way to capture a list of tasks during a meeting.

  1. In a project's work items, click New work item at the bottom of the list, group, or column. In the Calendar layout, hover over a day to see it.
  2. Type a title and press Enter.

The work item takes the value of the group you added it to. For example, a work item added to the In Progress column on a board gets the In Progress state, and one added under a label group gets that label. In the Calendar layout, it gets the day you picked as its due date. Everything else uses the project's defaults, and you can fill it in later.

Quick add work item

Other ways to create work items ​

MethodUse it when
Create via URLYou want a link, bookmark, or script that opens the create modal with fields already filled in.
Work item templatesYour team files the same kind of work item often, such as bug reports or onboarding checklists.
Recurring work itemsThe same work repeats on a schedule, such as a weekly report.
IntakePeople outside the project, or outside Plane, need to submit requests for your team to review.
Sub-work itemsYou're breaking a larger work item into smaller pieces.
ImportersYour work items are in Jira, Linear, Asana, ClickUp, or a CSV file.
Plane AIYou want to describe the work in plain language and let Plane AI draft the work items.

Edit a work item ​

You can change a work item in three places:

  • In a layout. Click a property on the work item's row, card, or cell and pick a new value. The List, Board, and Table layouts show the properties you choose in display options.
  • In the work item. Click the work item to open it and change anything in the title, description, or properties. See Work item details.
  • Several at once. Select work items in the List or Table layout and change a property for all of them. See Bulk operations.

Plane saves each change as you make it and records it in the work item's activity.

Make a copy of a work item Pro ​

Use Make a copy to create a new work item from an existing one, in the same project or in a different project in the workspace. It's useful for reusing a well-written work item or handing work to another team.

  1. Open the work item, click the ••• menu at the top right, and choose Make a copy. You can also right-click the work item in a layout.
  2. Choose the destination project. The current project is selected.
  3. Click Done.

The copy gets a new ID from the destination project. Plane links the copy to the original with a Duplicate of relation, so you can always trace where it came from.

To copy many work items at once, see Copy work items.

What gets copied ​

Some properties, like cycles, modules, and estimates, belong to a single project, so they can't follow a work item into another project.

PropertyCopy in the same projectCopy to a different project
TitleAdds (Copy) to the endUnchanged
Work item typeKeptThe destination project's default type. See the note below.
StateKeptA starting state in the destination project
PriorityKeptKept
Start and due datesKeptKept
DescriptionCopiedCopied
Links and attachmentsCopiedCopied
RelationsCopiedCopied
ReleasesKeptKept
AssigneesKeptCleared
LabelsKeptCleared, unless your workspace uses Workspace Governance
CycleKeptCleared
ModulesKeptCleared
EstimateKeptCleared
Custom propertiesKeptAdded to the end of the description as text
ParentClearedCleared
Sub-work itemsNot copiedNot copied
Customer requestsNot copiedNot copied

Custom property values can't carry across projects as structured fields, so Plane writes them into the copy's description instead. Nothing is lost, but you need to re-enter them in the destination project's properties if you want to filter or group by them.

Work item types across projects

If your workspace uses Workspace Governance, the copy keeps its type as long as that type is active in the destination project. Otherwise it gets the destination project's default type. This applies to epics too. If the destination project doesn't have the Epic type, the copied epic becomes a regular work item.

A few more things to know:

  • Copying an archived work item creates an active work item, not an archived one.
  • You need permission to create work items in the destination project.

Archive a work item ​

Archiving takes a finished work item out of your active lists without deleting it. Archived work items keep all their data and stay searchable, and you can restore them at any time.

You can only archive work items in a Completed or Cancelled state. For other work items, the Archive option is turned off.

  1. Open the work item, or right-click it in a layout.
  2. Click the ••• menu and choose Archive.
  3. Click Archive to confirm.

To archive several work items at once, select them in the List or Table layout and use bulk operations. To archive work items automatically after they've been closed for a while, turn on Auto-archive closed work items in the project's automation settings.

Archived work items

Find archived work items ​

Click the ••• menu next to the project name in the sidebar and choose Archives, or press G then R inside the project.

An archived work item is read-only. You can open it and read its description, properties, comments, and activity, but you can't edit it, comment on it, vote on it, or subscribe to it until you restore it.

Restore an archived work item ​

  1. Open the archived work item from the project's Archives.
  2. Click the ••• menu and choose Restore.

The work item goes back to the project's active work items with all its properties and history.

Delete a work item ​

Deleting a work item removes it permanently. You can't undo it.

WARNING

Deleting a work item also deletes all of its sub-work items and attachments. If you want to keep a sub-work item, remove it from the parent before you delete the parent.

  1. Open the work item, or right-click it in a layout.
  2. Click the ••• menu and choose Delete.
  3. Click Delete to confirm.

Admins can delete any work item in the project. Contributors can delete only the work items they created. If you're not sure you'll need a finished work item again, archive it instead.