> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semgrep.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag projects

>  Tagging enables you to group projects together based on your organization's unique business structure or needs. By tagging projects, you are able to quickly apply Supply Chain policies and other Semgrep features to specific groups.

Add tags for specific projects in the Semgrep AppSec Platform through the following methods:

* Set tags through the **Semgrep AppSec Platform > Projects > Project details** page.
* Set tags using the Semgrep AppSec Platform API.
* Set tags in your repository's `.semgrepconfig.yml` file.

<Warning>
  **SETTING TAGS**

  * Keep in mind, when setting tags via the `.semgrepconfig.yml` file or Semgrep AppSec Platform API, that these actions **supersede** any tags previously set.
  * For example, if you set tags through the API and subsequently run a CI scan, then the previous tags set by the API will be overwritten by any tag definitions in the `.semgrepconfig.yml` file of the repository.
  * For this reason, the Semgrep team recommends exclusively choosing either the API or `.semgrepconfig.yml` file to manage and set tags. **Do not use a mix of the two.**
</Warning>

## Set tags through Semgrep AppSec Platform and the API

To manage tags through Semgrep AppSec Platform, follow these steps:

<Steps>
  <Step>
    Go to the Semgrep AppSec Platform [Projects](https://semgrep.dev/orgs/-/projects) page.
  </Step>

  <Step>
    Find the project you want to modify, then click its **<Icon icon="window-restore" iconType="regular" /> icon** under **Details**.
  </Step>

  <Step>
    Click the **Settings** tab.
  </Step>

  <Step>
    Add or remove tags under the **Tags** section.
  </Step>

  <Step>
    Click **Save**.
  </Step>
</Steps>

Refer to [Semgrep API documentation](/api-reference/v1/projectsservice/add-tags-to-project) to use the API.

## Set tags in `.semgrepconfig.yml`

You can also add tags through a specific file added to your repository. To do so, follow the instructions below:

<Steps>
  <Step>
    Create `.semgrepconfig.yml` file in the root directory of your repository.
  </Step>

  <Step>
    Add tags to the `.semgrepconfig.yml` file. Example of tags added to `.semgrepconfig.yml` file:

    ```yaml theme={null}
    tags:
        - favourite
        - awesomeproject
    ```
  </Step>
</Steps>

<Warning>
  **CAUTION**

  Changes to tags made through the `.semgrepconfig.yml` file are also visible in the **Semgrep AppSec Platform > Projects** page, however, the inverse is **not** true (changes in Semgrep AppSec Platform > Projects page will be overwritten by `.semgrepconfig.yml`.)
</Warning>