Project tags

Introducing tags

A project tag allows you to add additional custom metadata to Snyk Projects.

Using tags in the Web UI

In the Snyk Web UI, you can:

• Create tags

• Apply and remove tags from Projects

• Filter Projects using tags

Other ways of using tags

You can also add and remove tags using:

• Snyk API Project tags endpoints

• The Snyk CLI option --project-tags. See the CLI commands and options summary. for the commands that support this option.

Tag conditions

The following conditions apply to Project tags:

• Keys are limited to 30 characters

• Values are limited to 256 characters.

• Keys allow only alphanumerics and the following characters -, _

• Values allow these characters plus /, :, ?, #, @, &, +, =, %, ~

• You can create 1000 unique key and value combinations per group, and apply 10 unique tags per Project.

• Reusing a key and value combination does not add to the count.

Create tags

To create a new tag for a Snyk Project:

1. On the Project details page, under TAGS click Add a key/value...\

   
2. Add the new key and click Enter.

3. Add a new value and click Enter.

You have created a new tag. When a new tag is created, it is automatically applied to the Project it was created in. The tag can also be used for any other Project in the Group.

You can apply multiple Project tag values to the same Project tag key.

Apply and remove tags

If a tag exists in your Group, you can apply it to any Snyk Project.

1. Click the + icon under TAGS.

2. You can either select a key from the list of recently used keys or type out the key for the tag you want to apply to the Project.

3. You can either select a value from the list of recently used values or type out the key value you want to apply to the Project.

4. After you select the value, the tag is applied to your Project.

5. To remove a tag from a Project, click the x for the tag.

Filter Projects listing by tags

When Group by none (ungrouped) is applied to the Projects listing page, you can filter the list by tags using the option in the menu.

There is a filter by tag autocomplete. This is intentionally limited to a small number of results. If your tag is not displayed, enter more characters for the tag until it rises to the top of the results.