# Organize prompts with tags

Create project tags, import a simple CSV, assign tags to prompts, and understand what the AI suggestion action actually does.

Canonical: https://docs.equalai.io/tracking/tags
Markdown: https://docs.equalai.io/tracking/tags.md

Tags are reusable labels for organizing a project's prompts. A prompt can have several tags. Tags are also used as annotation categories, so treat tag names as shared project vocabulary rather than private labels.

## Create a tag manually

With the intended project selected, open **Tags**:

1. Choose **Create Tag → Create manually**.
2. Enter a required **Name**.
3. Optionally add a **Description** explaining when teammates should use it.
4. Choose **Save Tag**.
5. Return with **Back to tags**.

Creating a tag does not assign it to any prompt. The list shows **Name**, **Description**, and **Prompts**, so a newly created tag can legitimately have a count of zero. Search matches tag names and descriptions.

![EarlySEO Tags list showing tag creation and CSV import, search, and prompt counts](https://docs.equalai.io/images/guides/tags.webp)

*EarlySEO example tags. **1.** Create a tag or import CSV. **2.** Search existing tags. **3.** Prompt count for each tag. A listed tag and its prompt assignments are separate; your names and counts will differ.*

**Synthetic example:** a fictional retailer could use `Buying guide` with the description `Questions about choosing equipment`. Keep labels concise and distinguish them from the full text of a tracked prompt.

## Assign tags to a prompt

Open the prompt's **Add tags** control or existing tag-count control.

1. In **Manage tags**, search for the tags you need.
2. Select or deselect the entries.
3. Choose **Save** to apply the selection.

**Clear tags** clears the pending selection; choose **Save** to apply that change. **Cancel** closes the picker without applying it. If no tags are available, create them in Tags first.

The picker changes the selected prompt, not every prompt in the project. A tag definition and a prompt's tag assignment are separate things.

## Import tags from CSV

Choose **Import tags from CSV** and select a simple CSV file. The first nonempty row must be a header. Use the first column for the name and the second for the description.

This synthetic example contains no customer data:

```csv
name,description
Buying guide,Questions about choosing equipment
Product comparison,Questions comparing alternatives
```

Import up to 500 new tags in one batch. Keep both fields free of embedded commas; quoted CSV fields with commas are not supported by this importer. Do not use a multiline description. Additional columns are not imported.

Blank names and names already present in the project are skipped, with existing-name matching ignoring case. Review the table after import; a successful upload does not mean every source row created a new tag. The importer creates tag definitions, not prompt assignments.

## Use Create with AI

**Create Tag → Create with AI** opens **Create Tags with AI**. It requires at least one prompt; the generate action is disabled when the prompt count is zero.

**Generate Tags with AI** creates a content task titled **Generate tags with AI** to review tag suggestions. It does not automatically create tags or assign them to prompts. Treat the task as a review workflow: decide which labels are useful, create those labels in Tags, and assign them to prompts separately.

The return to the tag list after submitting the task is not confirmation that new tags were added.

## Edit and delete

Use a row's **Edit** action to update the tag, then **Save Tag**. Use **Delete** and confirm **Delete Tag** to remove the tag definition. Removing a label is not the same as deleting a tracked prompt.

Annotation categories share this tag list, but existing annotations retain their category text. After renaming a category tag, review older annotations if you want their category labels to stay consistent.

## Troubleshooting

- **No tags yet:** create one manually or import a correctly formatted CSV.
- **No matching tags:** clear search before assuming the project is empty.
- **AI action unavailable:** add a prompt, then reopen the page.
- **Import loses text:** remove embedded commas and verify the two-column format.
- **First tag missing:** check that the file starts with a header row.
- **Save denied:** confirm that you have project editing access and the required subscription access.

## Related guides

- [Annotations and shared categories](https://docs.equalai.io/tracking/annotations)
- [Create your first tracking set](https://docs.equalai.io/getting-started/onboarding)
- [Project roles](https://docs.equalai.io/account/team-members)