Finding and organizing components by using tags

When you have many components, use tags to group them so you can find and view them easily. Organize components and manage their tags on the Browse Components page in the Global Configuration Management (GCM) application. To manage tags for one component at a time, edit the component and go to the Attributes tab.

Before you begin

To work with tags:
  • You must have permission to modify component properties.
  • To define tags, you must have permission to modify component properties, and create and rename tags.
  • To rename tags, you must also have permission to create and rename tags. You can rename tags only on the Browse Components page.
To remove tags from a component:
  • You must have permission to modify component properties.
  • If a tag is removed from all the components it is applied to, it is also removed from the Tags section on the Browse Components page.

About this task

  • Important: Avoid adding classified or sensitive data such as customer names and proprietary information to tags. If you must scrub the GCM data later, tags are removed from the artifacts you scrub, but the tags are not permanently deleted from the repository. See Deleting sensitive data from global configurations and components by scrubbing them.
  • Tags are strings without spaces or commas and are project-area specific. You can nest tags to represent a hierarchy, such as country/state/city. The forward slash (/) separates tag levels:
    Tag named country, which has a nested tag named state, which in turn has a nested tag named city
  • Tags do not organize components into a physical hierarchy; they simply help you to view them in logical groups.
  • Tags do not span project areas. Queries for tags show only the configurations from the same project area as the query. If a configuration lead defines the same tag in multiple project areas and you must rename or delete a tag to suit your project needs, you must query configurations in each project area for the tag.
  • Consider creating different tags for configurations and components. Otherwise, if you use the same tags for components and configurations, renaming or deleting a tag on the Browse Components page affects only components; renaming or deleting by querying configurations affects only configurations. For details about renaming tags for configurations, see Adding tags, attributes, and links to a global configuration or component.

    To manage tags for a configuration, edit the configuration, click the Attributes tab, and make changes in the Tags field. Then, save your changes.


  1. From the Home menu, open a GCM project.
  2. On the Welcome page, click Browse and create components.
  3. Tag the components.
    Task What to do
    Browse components by tag Show components by clicking All Components, Untagged, or one tag in the tree.

    Find components by searching by name or tag above the list of components. If you type multiple tags, you find only components with all those tags.

    Show archived components and their tags by clicking Show archived components Shows the archive icon near the upper right of the page. Click it again to show active components.

    Tag components

    Define, add, or remove tags by selecting one or more components, and from the Actions Shows the Actions menu icon menu, click Tag Components. Type to add a tag name, or use the controls for other actions, and click OK.

    Add a tag to multiple components at a time by dragging them to the tag in the Tags section. You can add multiple tags to components.

    Remember, you can also define, add, and remove tags on the Attributes tab when you edit a component.

    For details, see Creating tags.

    Rename tags In the Tags section, right-click a tag and select Rename Tag.

    You can also change nesting by adding or removing a forward slash (/) between tags.

    Delete from all components In the Tags section, right-click a tag and select Delete Tag. The tag and any nested tags are removed from components, and you can no longer use them. You can re-create a deleted tag again if you need it.

    Example: Again, consider this tag structure:

    Tag structure showing a tag named country, which has a nested tag named state, which in turn has a nested tag named city

    In the Tags section, when you delete the state tag, the country/state and country/state/city tags are removed from components and you can’t use the state/city tags. You can still use the country tag.

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