> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/creating-content/content-structure/page/tags.md).

# Tags

Use tags to group related content, convey release states, mark outdated content, or anything else that helps readers scan your documentation.

#### Tag a page

1. Open the page.
2. Hover over the page title and open **Page options**.
3. Add one or more tags.

Drag tags to change the order in which they appear on the page.

#### Show or hide tags on a page

Tags display at the top of the page by default. To hide a page's tags while keeping the associated metadata:

1. Open **Page options**.
2. Turn off **Show tags on page**.

#### Display a tag in the table of contents

For each page, you can pick one tag to display in the table of contents. To choose which tag displays:

1. Open **Page options**.
2. Under **Tags**, choose your tag from the **Display in table of contents** dropdown.

#### Tag an update block

Each update block can have its own tags.

1. Open the update block.
2. Click **Add tag** below the date.
3. Use the tag picker to add, remove, or reorder tags.

#### Manage tags in the Library

To view, create, and manage tags for your section:

1. Open the **Library** from the table of contents.
2. Click **Tags**.

Each tag has:

* A label — what readers see
* A slug — a stable identifier
* An optional icon or emoji

#### Tags in Markdown

If you use Git Sync, tags appear in the page frontmatter:

```yaml
---
description: "Tags are reusable labels you can add to pages and update blocks — this page tells you how to create, add, and manage tags"
tags:
  - news
  - experiment
  - tag: beta
    primary: true
  - pro
---
```

Use a string for a standard tag. Use `primary: true` on one tag to make it the page's primary tag — GitBook can show that tag in the table of contents.


---

# 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://gitbook.com/docs/creating-content/content-structure/page/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.