# Tags

You can use tags to group related content, convey release states, mark outdated content, or in any other way that helps your readers scan your documentation.

{% hint style="info" %}
**Note:** Tags are currently in beta as we consider adding more features — including search functionality and color support. If there are specific features you want to see for tags, please [let us know in our GitHub community](https://github.com/GitbookIO/community)!
{% endhint %}

## Tag a page

Open the page, then open **Page options** — accessible by hovering over the page title — and add one or more tags. You can drag tags around to change the order in which they appear on the page.

### Show or hide tags on a page

By default, tags will be displayed at the top of the page. To hide a page’s tags while keeping the associated metadata:

* Open **Page options**
* Turn off **Show tags on page** to keep tags as metadata only

### Display a tag in the table of contents

For each page, you can pick one tag to display in the [table of contents](https://gitbook.com/docs/creating-content/content-structure/page#table-of-contents) — as you can see with this page. To choose which tag displays:

* Open **Page options**
* Under **Tags**, use the **Display in table of contents** dropdown to choose your tag.

## Tag an update block

Each individual [update block](https://gitbook.com/docs/creating-content/blocks/updates) can also have its own tags.

To add a tag to an update block, navigate to the update and click **Add tag** below the date. You can then use the tag picker to add, remove, or reorder tags.

## Manage tags in the Library

To view, create and manage tags for your space, open the **Library** from the [table of contents](https://gitbook.com/docs/creating-content/content-structure/page/..#table-of-contents) and choose **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.

GitBook keeps the tag order from the list.


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/creating-content/content-structure/page/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.