# Topics

## Overview

Topics are a feature in the Web App that allow you to associate specific labels with a repository. Topics will allow you to tag, search, and navigate repositories based on a location, purpose, or a separate taxonomy.

Topics have endless use cases and are an extremely powerful organizational tool. Some common implementations of Topics are outlined below:

* **Location:** If an organization has 10 repositories that represent PLC projects for the stamping area in a factory, its users may add a "stamping" topic to each repository. This allows users in that organization to quickly find all repositories that relate to the stamping area in the plant.
* **Version**: If an organization wants to track the version or firmware of a program in a customer repository, its users may add a "V1" topic that reflects the current firmware of the program within that repository. This allows users in that organization to quickly identify which customer repositories have outdated versions.
* **Type**: If an organization wants to efficiently identify all of its repositories that are associated with a specific vendor, its users may add a "Siemens" topic to each repository that contains Step7 TIA Portal projects.

## Adding a Topic

Navigate to the *Files* view in your repository and enable the *Show Topics* toggle near the top of the screen.

![](/files/RmbmTPNeE1UBT6S1E2gC)

You can view, add, and delete topics once the *Show Topics* toggle is enabled. To add a new Topic, enter a Topic name and press the teal *+* icon.

![](/files/x9O2f5qVds51qbtZxAoA)

The new Topic will appear as an interactive chip.

<figure><img src="/files/KDj83yaDkETIUijdGt6a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can add up to a maximum limit of 25 Topics to a repository
{% endhint %}

## Deleting a Topic

Click on *Manage Topics* to remove a Topic.

![](/files/S6GeiZc9F0WvPJpKGegX)

Any Topics that are associated with your repository will display in red. Click anywhere on the chip to remove it from the repository.

![](/files/x8MQpZ14AgKy3YdrZ1aR)

Click the *Save Changes* option to save your work.

<figure><img src="/files/cN6yi9EHadKFFuQO6rPM" alt=""><figcaption></figcaption></figure>

## Searching by Topics

You can use a topic to search for a repository from the *Dashboard*.  Select the Repositories tab, and Topics that have been assigned to a repository will be displayed as interactive chips.

<figure><img src="/files/q1fZe9gWd0LIYkWMV78S" alt=""><figcaption></figcaption></figure>

To filter a list of repositories that have been assigned a certain topic, either click on a topic from the repository list or search for a topic by clicking into the *Search for Repositories...* field. The list will display repositories that have the chosen topic assigned to them. You can clear the filter condition by clicking on the red *X* within the active chip.

<figure><img src="/files/0BLyUZEaaUhwnNCMxVGX" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.copia.io/docs/git-based-source-control/additional-features/topics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
