Archiving and restoring components in the QM application

Archive components that you no longer use or that are obsolete to simplify the list of components that you see. You can also archive components to prevent team members from adding configurations of those components to global configurations. Archiving a component does not delete it. You can restore it when you need it again.

Before you begin

  • A Quality Management (QM) project area administrator must enable configuration management for the project.
  • You must have permission to delete and restore components.
Important: If a component contains classified or proprietary data that should not be shared with a wider audience, delete that data by scrubbing the component. See the related topic.

About this task

  • In the QM application (except for the Trash view), you archive items by using the Delete task. You can restore them from the trash later if you need them again.
  • In the Trash view, use the Delete task to permanently delete items. However, you cannot permanently delete components, streams, and baselines because artifacts reference these items. Removing the references would cause unexpected results.

You might archive components that are no longer in use, that were created for temporary use only or by mistake, or whose artifacts were cloned to newer components.

When you archive a component, the system archives all of the configurations of that component. Archived components and configurations are typically hidden from view in the application and are visible only in the Trash view; however, you see archived configurations in the application when they are referenced by an active configuration. Archived configurations have a gray icon beside their name, as in this example of an archived stream: Gray icon to represent an archived stream

You cannot edit archived components or configurations, and you cannot add archived configurations to global configurations. Archived items are not displayed in search and query results. Report Builder reports do not include data from archived items.


  1. Open a project from the All Projects view:
  2. Complete the steps for the action you want to take.
    • To archive components:
      1. On the toolbar, click Administration Administration menu > Manage Components and Configurations.

        The Components page shows the list of components for the project you are working in.

      2. From the Action Menu beside a component name, click Delete Component.

      The component and its configurations are archived. The archived streams and baselines are still shown in the version tree so that you can see the full version history, but the configuration is annotated as archived.

    • To restore components:
      1. Click Administration Administration menu > View Trash
      2. From the View menu, select Component. The list of archived components is shown.
      3. From the Action Menu beside a component name, click Restore Component.

      The system restores the component and all its configurations, and you can now see the component and its configurations in the application. To see the restored items, you might need to refresh the application page that you work on.

What to do next

To return to the list of components, click Administration Administration menu > Manage Components and Configurations.

To resume work in the current project, select a component and configuration from the Current Project Component and Current Configuration menus on the toolbar.

To resume work in another project, select it from the Home menu Home menu or the All Projects view.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki