Share this page

# Convert backlog items

You can convert epics, features, user stories, quality stories, and defects to other backlog item types.

In this topic:

## Supported conversions

The following table describes which conversions you can perform:

Convert from entity | Convert to entity
--- | ---
Epic | Feature
Feature | Epic, User Story, Defect
User Story | Feature, Defect, Version 24.3 and later: Quality Story
Version 24.3 and later: Quality Story | User Story, Defect
Defect | Feature, User Story, Version 24.3 and later: Quality Story

Back to top

## Prerequisites and behaviors

To convert one entity to another, the user must have the Delete permission on the source entity type, and the Create permission on the target entity type.

The conversion behaves as follows:

- When the source entity type includes a field that does not exist in the target entity type, that field value is lost.
- If both the source entity and target entity have a custom field with the same name and type, the value persists unchanged.
- After the conversion, the target entity's phase is whatever is the initial phase for that entity type. Usually, this phase is New.
- During the conversion process, set field business rules and validations do not run. For example, required fields persist as empty.
- The source entity's attachments, comments, commits, tests, and history persist into the target entity.

- When converting an entity to or from a quality story, linked tests and runs do not persist.

Back to top

## Convert a backlog item

You can convert backlog items from one item type to another type.

To convert a backlog item:

1. Open a backlog item of a supported type. For details, see Supported conversions.
2. In the Details tab, click More and select Convert.
3. Select the new entity type, and complete the conversion.

Back to top

See also:

- Duplicate and delete items
- Build the backlog

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ALM Octane Help Center ALM Octane Help 23.4-24.3 All View Local Help Center View Online Help Center Version: