> For the complete documentation index, see [llms.txt](https://software-help-docs.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-help-docs.gitbook.io/knowledge-base/software-guide/settings/settings-tags.md).

# Settings: Tags

The tag feature is a great way to organize your contacts. Adding and removing tags will help you determine specific actions and stages that a contact is at (similar but more granular than a pipeline stage). You can add more than one tag to contact.

**How to Create, Add & Remove Tags:**

* You can create tags, directly by going to Settings - Tags - New Tag. Then, add the name of the tag and click on Submit.

{% embed url="<https://lh3.googleusercontent.com/I9zXCV-Rbdso7mGOoSUAHuiekqf2HzWlTmZVe9syzNxYUFx60EhneF7mvoKcN6-a8RZGWo1h_4aZNCwBI2Gt9plmUk3V3Ld3xPOYQd8tAh9QFolUDcKiOfZ0e64ZVMMval74wypPJeuI2LVUKR4BzXs>" %}

{% embed url="<https://lh3.googleusercontent.com/PZyPAeKpB-r6c3VMJTtdwfFIufmq1IHSLEHd3Tj9bQjC3czgbDcWfeBCtGL3hJZAmZuNgGfJnimNLfsSJJDdkbDBKWcghf-tx-Btfp4x59C2V_fVUuKJYzRYDnTTaKzfoB4mF-PFn1dcBS42T3WRsog>" %}

* When importing a list of new contacts, you can add tags to some contacts in the spreadsheet you upload, or apply a tag to the list as a whole. (Refer to the "How to Import Contacts" article for the step-by-step.)
* A tag can be manually added or removed within an individual contact record.
* To add a tag, under the ACTIONS section of the Contact card, type in the desired tag. If you have used this tag previously it will show up, and you can simply click it. If it is new, you can select Plus, and it will create a new tag.
* Tags can also be added and taken away via the conversations menu.

{% embed url="<https://lh6.googleusercontent.com/qE1B79gWb09-sUGW717V8Yd0Fn-DRYyFUUAmCCj_nK8nMKGEP-6Dz4TIkUzuhSCyPNgFiHh_v0QhEKArIrqWcdnsryWg7AI1TbWw39N3PXAsuYdGPgapULND4e94NplrVOLvF1hlfL-1qeg7Go1k5w>" %}

* A trigger can also be set up to apply or remove a tag to contact records. (Refer to the "How to Build and Utilize Triggers" article for the step-by-step.) Some options for the trigger action to prompt the tag-add are call status, updated appointment status, specified email(s) being sent, form submission, and more.
* The Bulk Actions within the Contacts section can be used to use a select-and-tag option. Check the box next to desired contacts, click the 'Add Tag' Icon at the top, and apply the desired tag. (This can be used to remove a tag too.)

**How to Use Tags**

* Tags can be used in the Smart Lists/Contacts to filter down to a specific group of leads/customers that you want to see.
* Tags are used to define a group of leads in order to send a Bulk Request (think Newsletter, Email Blast, etc.)

***NOTE:*** Tags should not contain special characters. The system will technically allow you to create a tag with a special character, such as "This & That" or "#Yes" but it will not pull the list of contacts properly if the tag has a special character. We recommend using text only (spaces are ok.)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://software-help-docs.gitbook.io/knowledge-base/software-guide/settings/settings-tags.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.