> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/getting-started/manage-teams-and-applications/add-labels-to-resources.md).

# Add labels to resources

Labels are custom metadata you add to repositories and container images in Aikido. Use them to group resources on different metadata properties.

Examples include `payments`, `production`, `frontend`, `lambda` , `critical`, `PII` etc.

{% hint style="info" %}
Labels are not the same as a container's **Scanned tag**. The scanned tag controls which image version Aikido scans. Labels only help you organize resources and filter issues.
{% endhint %}

### Manage labels on a repository

1. Open **Repositories** and select a repository.
2. Open the **Settings** tab.
3. In the **Labels** card, click **Edit**.

<figure><img src="/files/B3D4bQF26Umm2BfXirdm" alt="" width="375"><figcaption></figcaption></figure>

Each repository can have multiple labels. Labels are free-form text.

You need permission to manage repositories. Team-restricted users can only edit labels on repositories they can access.

#### Import repository labels from GitHub

For GitHub repositories, Aikido can import GitHub topics as labels. These synced labels are read-only in Aikido. They stay in sync with GitHub topics automatically. You can still add manual labels next to them. **Contact us to enable this functionality.**

### Manage labels on a container

1. Open **Containers** and select a container image.
2. Open the **Settings** tab.

You need permission to manage containers. Team-restricted users can only edit labels on containers they can access.

#### Automatic labels from workloads

If your Kubernetes or cloud workload integration is connected, Aikido can promote workload labels onto the container.

Today this supports `owner` and `team`. Aikido formats them as `owner:<value>` and `team:<value>`.

These labels are managed by the integration. You can't edit or delete them manually. Manual labels stay separate and remain editable.

### Filter the issue feed by labels

1. Open the main **Issues** feed.
2. Open **Quick filter**.
3. Select the labels you want to keep.

The **Labels** filter only appears after at least one label exists in your workspace. In some versions, this filter appears as **Repo Labels**.

<figure><img src="/files/vIUe3sidnPb6UVqBNFbD" alt="" width="364"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/getting-started/manage-teams-and-applications/add-labels-to-resources.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.