Tagging issues

This page contains:

• Tagging an Issue
• Default tags vs. custom tags
• Using tags in your reports

The most common use of tagging is to help visualizing the data in your project.

It doesn't really matter what risk rating your are using (CVSS, DREAD, High/Medium/Low, Impact and Probability scores, etc.) you will almost always want to be able to see a graphical representation of the issues identified so far:

To adjust the tags associated to your issues, head over to All issues on the sidebar. By default you'll land in the Summary of issues screen, where you can review and adjust the tags:

If you open any Issue description, just click Summary of issues to go back again to the table.

Tagging an Issue

To adjust the tags of a given issue, select it with the checkbox in the corresponding row to trigger the actions toolbar:

Open the tags drop-down menu and select the tag to be applied:

You can select multiple rows to apply the same tag to different items.

You can also add tags to issues by using a Tags field when creating (not updating) an Issue.

1. Add the Tags field to your Issue with the following line:
   

   #[Tags]#

2. Decide on the color of your tag and find the corresponding Hex code. In our example, we're going to create a purple tag (Hex: #9467bd).
3. Decide on your tag name. In our example, we're going to use the tag name Critical.
4. Build the tag by using the following format for the Tags field value:
   ![HEX]_[NAME]
   In our example, the finished tag value is !9467bd_Critical.
5. Insert the value you just created under the Tags field in your Issue. In this example:
   

   #[Tags]#
   !9467bd_Critical

Similarly, you can add tags to issues when creating them with the REST API using the #[Tags]# field.

Default tags vs. custom tags

Out of the box, your Dradis projects will be created with the following set of tags:

If you want to have different tags (or a different number of them), just create a project template with the definitions for the tags you want.

Head over to the Project templates page in the Administration manual to learn more.

Using tags in your reports

When creating your report template, you can filter issues by tag using the following filter definition:

Tag|<Name>

For example:

Tag|Critical

Learn more about filtering and filter definitions in the Filtering and sorting page of the Custom Word reports manual.