Skip to main content

Feature

A feature is a folder for related tasks inside a project, such as everything that makes up one part of your product. Features appear under their project in the sidebar; select one to see only its tasks on the task board. A task that isn't filed under a feature sits directly under its project.

For the steps, see Organize tasks into features. For how features relate to projects, epics and tasks, see How tasks work.

Creating a feature, and filing tasks under one, needs permission to create tasks in its project.

New feature​

The New feature page: Project, Name, Description, and Cancel and Create

On a task's page, select where it's filed in the breadcrumb, then New feature…. The New feature page opens, under the breadcrumb Tasks › New feature. To add a feature by name alone, select + beside its project in the sidebar; see Arrange features in the sidebar.

FieldWhat it means
ProjectThe project the feature belongs to; only that project's tasks can be filed under it. Lists the projects you can create tasks in. Opened from a task's breadcrumb, it is fixed to the task's project.
NameThe feature's name, up to 200 characters. Required.
DescriptionShown above the feature's tasks. Optional, up to 2,000 characters.

Name and Description stay unavailable until a project is picked, and Create until the feature has a name. If you can't create tasks in any project, the page says You cannot create features in any project. If your projects can't be loaded, it says Could not load your projects.; if creating fails, Could not create the feature. or the reason under the field at fault.

Select Create to add the feature. Opened from a task's breadcrumb, you return to the task, filed under the new feature; opened from a link, Create opens the new feature's page. Cancel leaves without it; if you have typed anything, it opens Unsaved changes first: This feature has not been created yet. Create it before leaving?, with Cancel (stay), Discard (leave without it) and Save (create it, then leave).

File a task under a feature​

On the task page, select the first crumb of the breadcrumb. It names the project, then the feature after a / when the task is in one, such as acme / Billing. A Search box over the list matches project and feature names; if nothing matches, the list says No matches.

The breadcrumb's lookup: a search box, the task's project, New feature… under it, then other projects

ItemWhat it does
The task's project, such as acmeListed first. Takes the task out of its feature, back to its project.
A featureListed under the project. Files the task under it. Only the project's features are listed; deleted ones are not.
New feature…Opens the New feature page. After Create, you return to the task, filed under the new feature. Shown only if you can create tasks in the project, and not while the task has unsaved changes or you're searching.
Another projectMoves the task there, in no feature. Listed after the task's own project.

The feature's description​

When you select a feature in the sidebar, its description shows above its tasks, if it has one. There is no header block. Edit and Delete are in the feature's ⋯ menu on its sidebar row; they show only if you can change the feature.

Delete​

Delete is in two places: the feature's ⋯ menu in the sidebar (beside Edit, which opens the feature's page) and the bottom of the feature's page. Each shows only if you can change the feature, and always asks you to confirm: Delete “”?, then Its ideas move to the project. Started tasks keep it. No task is deleted., with Delete. The feature leaves the sidebar, pickers and filing, and can't be opened, edited or filed into. Its draft tasks move to the project; its other tasks keep the feature, so the pipeline's later stages still group them under its name and past releases still list it. No task is deleted. From the feature's page, a deleted feature returns you to its project's board.

The feature's page​

Edit in the sidebar row's ⋯ menu opens the feature's page: the project, the feature and Edit in the breadcrumb, the feature's icon and name as the title, and the form below. Hover a setting's label for what it does.

FieldWhat it means
IconThe feature's icon, before its name. Select Choose icon (the empty slot), or the icon itself, to pick from the palette: No icon, one of 24 shapes (three shapes in eight colours, named such as Red triangle), or any emoji, found with Search emoji.
NameNames the feature on the board and in the sidebar. Required, up to 200 characters. Without one, the page says A feature needs a name.
DescriptionShown above the feature's tasks. Optional, up to 2,000 characters.
OwnerWho leads the feature; at first, whoever created it. Lists the people in your organization who can edit tasks in the project, plus the current owner, and always names someone. Being owner grants no access. If the list of possible owners can't load, the field says Could not load the other possible owners.
Show progressOff by default. On, the sidebar draws a completion ring beside the feature's name; hover the ring to see how much is done. Applies for everyone.
CreatedWhen the feature was created, and by whom.

Select Save to keep your changes, or Cancel to leave without them (it asks first: see Unsaved changes); both return to the feature on the board. Delete removes the feature, as in Delete. If you can open the feature but not change it, the page says You can view this feature but not edit it., every field is read-only (Owner shows the owner's name), Back replaces Cancel, and Save and Delete are hidden.

If the feature was deleted, or the link is out of date, the page says Feature not found. If the page can't load the feature for another reason, it says Could not load this feature. If Save fails, the reason shows under the field at fault, or at the top of the form; if Delete fails, at the top.

Unsaved changes​

Leaving the page with changes you haven't saved, with Cancel, a link, the sidebar or the browser's Back, opens Unsaved changes: This feature has changes that have not been saved. Save them before leaving?

ButtonWhat it does
CancelCloses the dialog and keeps you on the page with your changes.
DiscardLeaves without your changes.
SaveSaves your changes, then leaves. If saving fails, you stay on the page.

Reloading or closing the tab with unsaved changes gets your browser's own warning instead. Delete leaves without asking.

Hide​

Hiding a project or a feature takes it out of the sidebar and its tasks out of everything above it, for you only: other people's boards don't change.

  • Select Hide in the project's or feature's ⋯ menu in the sidebar, or select a project's eye on the Projects list. Show reverses it.
  • On All projects, a hidden project's or feature's tasks are left out. On a project, its hidden features' tasks are left out. Its counts are left out of the counts above it.
  • To see hidden ones in the sidebar, select the eye, Show hidden, in Find a project or feature (shown only while something is hidden, with how many). They appear greyed, without their stopped count or completion ring, and everything under a hidden project is greyed too. Select one to see its tasks, or Show it from its ⋯ menu. Select the eye again to leave them out.