Docs Tags are optional labels you can attach to any doc. They let you connect docs that live in different categories but share a topic.
A category answers “where does this doc live?” and gives your documentation its structure. A tag answers “what else is this doc about?” and cuts across that structure.
A doc belongs in one place, so it usually has one category. A doc can touch several topics, so it can have several tags.
Tags are also flat. Unlike categories, tags cannot have parents or children.
Tags earn their place when the same topic appears in several categories. For example, if docs in “Getting Started”, “Billing”, and “Troubleshooting” all touch on your API, tagging each one with “api” links them together.
If your documentation is small, you can skip tags entirely. A well organized set of categories is enough for most sites, and empty or barely used tags add clutter without helping anyone.
You can also add tags while writing a doc. In the editor sidebar, open the Docs Tags panel, type the tag name into the box, and separate multiple tags with commas or by pressing Enter. Any tag that does not already exist is created for you.
Tags get messy faster than categories do. A few habits help:
Deleting a tag does not delete or unpublish any docs. It only removes the label.