# 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.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FuF9kLpJPxpiGU60Bw0XZ%2FWebApp_ShowTopicsOff.png?alt=media\&token=b66c7172-794d-4717-ad07-2a69ec309c79)

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.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FNXnjhmrT0tgMW471673L%2FWebApp_ShowTopicsOn_Manage.png?alt=media\&token=30eb6219-2a53-46ce-baf4-fa2b58dcc84f)

The new Topic will appear as an interactive chip.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2Fflwml6VOi6hcVXG3K70V%2FWebApp_ShowTopicsOon_Created.png?alt=media&#x26;token=1a9c75b3-e44a-45a7-a396-02785bcf712a" 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.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FYmrtIC07YZ5AePXB9SIT%2FWebApp_ShowTopicsOon_ManageDelete.png?alt=media\&token=81f8c56b-2d95-4b74-bae5-40e40acbceb8)

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

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FXcTLBytxVKNlU8Lc8d2l%2FWebApp_ShowTopicsOon_Created_NowDelete.png?alt=media\&token=06450c7e-0d3e-4ff3-8558-9934c4169841)

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

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FwQqCxZwojBKJr1AQONii%2FWebApp_ShowTopicsOon_Created_NowDelete_SaveChanges.png?alt=media&#x26;token=6eeac070-f3ef-48ab-84e5-497d8fc68f89" 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="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FoGE0HLhjm3MiUJX0LqAk%2FTopicChips1.png?alt=media&#x26;token=53700206-f5b6-4391-bcd0-dbbe007358a2" 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="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FzisGdSuiPXOvDNsiz32Y%2FTopicChips2.png?alt=media&#x26;token=306b45fc-edb8-41fa-a2d2-f5b5fa62cfba" alt=""><figcaption></figcaption></figure>
