> For the complete documentation index, see [llms.txt](https://help.fielddoc.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fielddoc.org/essentials/tags-beta.md).

# Tags (beta)

{% hint style="info" icon="circle-user" %}
**Tier**: Tags in Beta mode are available to Standard Plan subscribers. Tags will be available to all users in the future.
{% endhint %}

## Organize and filter records with tags

Tags help you organize and find records in FieldDoc using categories that are meaningful to your organization. They give you another way to organize your data in multiple dimensions, beyond the restrictions of the folder tree structure of the portfolio.

Users can name both the categories and the tag names within each category. This allows each organization to create a data structure that can lead to easier data management and broader analysis opportunities.&#x20;

### When to use tags

Consider using tags when you want to:

* Find records that share a characteristic across your existing folder structure.
* View a group of records from another perspective, such as a funding source or responsible staff member.&#x20;
* Use category names that make sense for your organization’s work.

Before creating tags, consider how your team will name and use them. Consistent names can make records easier to find and help your team maintain an organized dataset over time.

For example, your organization might use folders to organize Activities by landowner or producer and tags to identify records associated with which staff member manages the records or the funder(s).

Tags can be added to folders or individual records. Tags added to folders are not automaticallly added to records within that  folder.

Multiple tags can be applied to a single record.&#x20;

### Creating Tags

Any Workspace Owner or Admin can create new tag categories and tags. The same users can assign tags to records in the workspace.&#x20;

{% hint style="warning" %}
You cannot add tags to records that have been shared with you from a third-party workspace.
{% endhint %}

* Tags can be added to folders, sub-folders, and records. Tags on Folders DO NOT cascade to the records contained within them.&#x20;
* Tags are contained to the workspace in which they were created.
* Tags can only be assigned to records that are "owned" by that workspace.&#x20;

### How to create a tag

Under **Tools**, select the **Tags** tab.

We recommend that you create categories for your tags before creating tags.

Within each category, you can add all related tags and color code them, if desired.

You can create multiple categories and lists of tags.&#x20;

{% @arcade/embed flowId="eljHFNfaSvI9iCNnmtkW" url="<https://app.arcade.software/share/eljHFNfaSvI9iCNnmtkW>" %}

### Add a tag to a record

#### Tag a single record/folder

Tags can be added anywhere you see an "add tag" prompt. These are available in your portfolio on the folder, sub-folder, and activity overview pages. Multiple tags can be applied to the same folder or record.

#### Batch add tags to multiple records

You can add a tag to multiple activity records at the same time.

From the portfolio main page, you have an option to view all records.&#x20;

* On the right hand side, select the button that says "select".&#x20;
* Select all records that you want to include in the tagging.
* Choose "add tag" and select your tag.
* The tag will be applied to all records.

{% hint style="info" %}
Batch is only available from the top level of activities. Use the filter buttons if you want to sort by folders.
{% endhint %}

### Tips for choosing tags

Choose names that are clear to everyone who will use them. Before adding a new tag, check whether your team already uses one for the same purpose.

For example, if your team uses tags to identify initiatives, agree on whether to use the full initiative name or an abbreviation—and use that naming approach consistently.

### Important notes

* Tags can be edited, archived, or deleted.
* Tags must have unique names.
* If you change a tag in the library of tags, it will be changed all places that it is used.
* Tags do not affect reporting.&#x20;


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.fielddoc.org/essentials/tags-beta.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
