Item conversion is an action performed in an event where work items are found to be bigger or smaller, compared to the original estimation and scope. Then, one would want to change the item's type to fit the correct level in the hierarchy.

In Craft.io, there are 8 different item types arranged in four levels of hierarchy.

Each item type in Craft.io has its own set of predefined and custom fields.
For example, a Feature item type in Craft.io has Visual Spec capability, a way to display a set of workflows and wireframes. While the Product item type acts as a logical container for Epics and does not have any custom fields associated to it.

In Craft.io you can change the type of an existing item to any other item type.
Items can be converted to a higher or a lower hierarchy level, one step at a time.

The following conversion options are available:

There are two locations in which you can convert an item type- in the Spec Editor or in a table view. Hover over an item's title and click the 3dots menu.
Select ‘Convert item’ and choose the desired item type from the available options.

Example: Conversion of an Epic to a Feature

You can convert multiple items at once via the Bulk operator. Bulk conversion option is available when the selected items are of the same hierarchy level (e.g. only Epics, Features etc..).

When converting an item, all its children items are converted as well, according to the new item type's hierarchy.
​

When converting a Feature to an Epic, the Sub-features will consequently convert into higher hierarchy level- Features.

Before conversion

After conversion

When this action is performed, Craft.io will create a new parent item to place the converted item nested within.

For example: Converting an Epic with the title 'Workflow' to a Feature.
After the conversion is completed, Craft.io will place the 'Workflow' feature under a new Epic titled "Parent of Workflow".

Before conversion

After conversion

Items that are already synced with a software development tool (e.g. Jira, AzureDevOps) require to be unsynced first, including all their children's items, to enable item conversion.
Only once the items are unsynced, the action can be accomplished.

Items that were previously synced with a development tool will 'remember' their dev tool counterparts.
Once the item is converted on Craft.io side, you can re-sync it with its dev tool counterpart simply by clicking the 'sync' button.
​Please note- in order to re-sync an item, the item counterpart on the dev tool side must be of the same type as the item in Craft.io.

The functionality entails implications on how the items will be managed after conversion. Please bear the below in mind before converting the items-