Create new tag

Creating a tag adds it to your project's tag library, making it available to apply to articles, category pages, and files in Drive. You can create tags from the Manage tags page before applying them to any content, or create them on the fly while working in the editor.

When to create a tag

• Create tags from the Manage tags page when you want to build out your tag library in advance before applying tags to articles.
• Create a tag on the fly from the editor or All articles page when you need a new tag while working on specific content.
• Create tags in Drive when you want to label files alongside related articles.

Create a tag

The primary method is from the Manage tags page, which gives you full control over the tag name, description, and group assignment.

1. Navigate to Content tools () > Tags in the left navigation bar.
2. Click Create tag at the top right of the page.
3. Enter the Tag name and Description in the respective fields.
4. Select a group to associate the tag with, if applicable. By default, the tag is created as an individual tag.
5. Click Create.

Other ways to create a tag

• From the article editor: Open an article, click the More () icon, and select Tags. In the Tags field, type a new tag name. If it does not exist, an option to create it appears in the dropdown. Select it to create and apply the tag simultaneously. Click Save.
• From Drive: Navigate to Drive () and open the file. Click the More () icon and select Add tags or View details. In the Tags field, type a new tag name and select the create option from the dropdown. Click Update.
• From the All articles page: Navigate to Documentation () > All articles (). Select one or more articles and click Create tags from the toolbar. Type a new tag name and select the create option. Click Save.

Tag limitations

Tag naming guidelines

Tag names support the following:

• Uppercase and lowercase characters, with multi-language support.
• Numbers.
• Spaces.
• Special characters: _ + - @ # % ^ & ! ()

Best practices

• Build your core tag library from the Manage tags page before publishing articles, so tags are ready to apply consistently from the start.
• Assign tags to a group at creation time to keep your library organised as it grows.
• Use tags that describe the topic, not the article type. "Authentication" is more useful than "how-to".
• Maintain consistent naming conventions across your team. Agree on casing, hyphenation, and singular vs plural before creating tags at scale.

FAQ