# Documentation Nexus IQ Server 1.26

**Nexus IQ Server 1.26**

Our documentation site has moved. For the most current version, please see [http://help.sonatype.com](http://help.sonatype.com)

## 10.1. Component Labels

Component labels are actually one of the more powerful features of policy management, and they should have a familiar look, since you’ve likely used other systems that employ a sort of tagging or labeling.

Essentially, component labels are metadata. More specifically a component label is metadata that is assigned to a component within the context of a particular application or organization. Labels can assist with identifying components you want to review, approve, or even avoid altogether. We call this component label assignment.

When component labels are assigned, this is an action that takes place in the application composition report. Before it can be assigned though, a label needs to exist for a particular organization or application.

As we learned in our [Organization and Application Management chapter](https://books.sonatype.com/sonatype-clm-book/1.26/html/book/org-app-management.html), inheritance plays a big role in policy. The same thing is true for labels, in that if a component label is created in an organization, any application attached to that organization will also have the label available for use when assigned. In fact, the system will prompt you to choose the scope (organization or application) a label should exist in when it is assigned.

| ![[Tip]](https://books.sonatype.com/sonatype-clm-book/1.26/html/book/images/icons/tip.png) |  |
| You can customize a policy to use a component label as a condition when IQ Server evaluates applications. For more information about policies and creating conditions, see the [Basic Policy Management](https://books.sonatype.com/sonatype-clm-book/1.26/html/book/basic-policy-management.html) chapter. |

### 10.1.1. Viewing a Component Label

To view a component label:

1. Click the _Organization & Policies_ icon  on the IQ Server toolbar.
2. Select an organization or application in the sidebar. A page of customizable settings is displayed.
3. Click _Component Labels_ in the menu bar at the top of the page to scroll to the _Component Labels_ section.

The _Component Labels_ section displays two types of labels:

- _Local_ - Component labels with a scope that’s specific to the selected organization or application.
- _Inherited_ - Component labels derived from an organization that’s higher in the system hierarchy than the currently selected organization or application.

**Figure 10.1. Component Label Section**

### 10.1.2. Creating a Component Label

To create a component label:

1. Click the _Organization & Policies_ icon  on the IQ Server toolbar.
2. In the sidebar, select the organization or application in which the component label will be used.
3. In the **Organization & Policies** area, click _Component Labels_.
4. In the _Component Labels_ section, click the _Add a Label_ button. The _New Component Label_ editor is displayed.
5. In the _New Component Label_ editor, set the following attributes:

1. _Component Label Name_ - Enter a name for the component label that is easily identified.
    2. _Short Description_ - Enter a description that provides additional information about the component label.
    3. _Color_ - Select a desired color for the component label.

6. Click the _Create_ button to add the component label to the selected organization.

A few things to remember:

- An organization’s component labels can be seen by any of its applications, the reverse is not true.
- Component labels can only be edited (or deleted) at the level they were created.

**Figure 10.2. Using the Add a Label Button**

### 10.1.3. Editing a Component Label

To edit a component label:

1. Click the _Organization & Policies_ icon  on the IQ Server toolbar.
2. In the sidebar, select the organization or application in which the component label was created. The component label is displayed in the _Component Labels_ section under the _Local_ heading, and has a chevron in its row to indicate it’s editable.
3. Click the component label you want to edit. The _Edit Component Label_ dialog is displayed.
4. In the _Edit Component Label_ dialog, you can change the following attributes:

1. _Component Label Name_ - Enter a different name for the component label.
    2. _Short Description_ - Enter a description that provides additional information about the component label.
    3. _Color_ - Select a desired color for the component label.

5. Click the _Update_ button to save the component label to the selected organization or application.

**Figure 10.3. Editing a Component Label**

### 10.1.4. Deleting a Component Label

To delete a component label:

1. Click the _Organization & Policies_ icon  on the IQ Server toolbar.
2. In the sidebar, select the organization or application in which the component label was created. The component label is displayed in the _Component Labels_ section under the _Local_ heading, and has a chevron in its row to indicate it’s editable.
3. Click the component label you want to delete. The _Edit Component Label_ dialog is displayed as shown in the figure, [Figure 10.3, “Editing a Component Label”](https://books.sonatype.com/sonatype-clm-book/1.26/html/book/label-management.html#fig-edit-component-label).  
4. In the _Edit Component Label_ dialog, click the _Delete Component Label_ button. A _Delete Label_ alert dialog is displayed.

| ![[Warning]](https://books.sonatype.com/sonatype-clm-book/1.26/html/book/images/icons/warning.png) |  |
| When you delete a component label, the action cannot be undone. |

5. In the _Delete Label_ dialog, click _Continue_ to delete the component label or _Cancel_ to keep the component label.