Before creating and adding categories and tags, it’s important to know:
- Why you should use them.
- When you should use them.
- Which one you should use.
- Where you should use them.
- How you should use them.
Comparison
Categories and tags are both used to group similar post content, but there are several differences between the two.
Table 1: Categories vs tags.
Categories | Tags | |
Purpose | Broad topics - Use for grouping the site's main topics. | Specific details - Use for grouping particular content in a post. |
Example | Lines. | Effective dates, Line of business, rates. |
Required | Yes. | No, but recommended. |
Hierarchy | Yes. Use the parent-child relationship to make navigating content easier for readers. | No. Tags are standalone entities. |
Limit per post | (1) - Adding more than one is bad for SEO. Only add more than one category per post if it makes sense for readers. | (1 - 10) - Adding too many is bad for SEO and defeats the purpose of tagging posts in the first place. |
Use in URL | Yes, but not recommended. This is a deprecated practice that isn't good for SEO. | No. |
Categories and tags have different uses, so before creating any, decide how and why you want to use them.
Usage
Use categories
You can use categories to:
- Group the site’s main topics.
- Create a hierarchy of topics.
- Improve navigation.
- Improve SEO.
Use tags
You can use tags to:
- Group posts with the same specific topics.
- Have posts appear in several sections of a site.
- Improve navigation.
Example category and tag usage
Here are two examples of how we use categories and tags on our site:
For Feature preview posts, select the following:
- Category: Features
- Tag: Feature preview
For Release notes posts, select the following:
- Category: Releases (formerly Release note)
- Tag: Release note
Categories
Categories are hierarchical and used for grouping the site’s main topics.
Name categories
Example:
- Category name: Lines
- Slug: lines
Categorize posts
In WordPress, you can add categories in two places:
- WordPress posts
- Categories screen
Add categories to a post in WordPress
To add categories to a post in WordPress:
- On the WordPress dashboard, in the left sidebar, select Categories.
- On the Categories screen, navigate to and hover over the title of the post you want to add a tag to, and then select Edit.
Note: You can add categories in both the Block Editor and Classic Editor.
- In the right sidebar, in the Categories box, select Add New Tag box, and then complete one of the following steps:
- To add an existing tag, in the All Categories list, navigate to and select the category you want to add.
- To create and add a new tag, type the name of the tag you want to add, and then select Add New Category.
Note: If the category you want to add is going to be a sub-category, in the Parent Category dropdown list, select the parent category.
- Select either Save as Authoring, Save as Pending Review, Publish, or Update.
Add categories on the Categories screen
To categories tags on the Categories screen:
- On the WordPress dashboard, in the left sidebar, hover over Posts, and then select Categories.
- On the Categories screen, complete the following steps:
- In the Name box, type the name of the category.
Note: The slug is the URL-friendly version of the category name. It’s usually all lowercase and contains only letters, numbers, and hyphens.
- In the Slug box, type the name of the slug.
Note: If the category you want to add is going to be a sub-category, in the Parent Category dropdown list, select the parent category.
- Skip the Description box.
Note: At this time, we do not have a reason to add descriptions to categories.
- Select Add New Category.
- In the Name box, type the name of the category.
Edit categories
Once you create a category, you can always go back and edit it.
To edit categories:
- On the WordPress dashboard, in the left sidebar, hover over Posts, and then select Categories.
- On the Categories screen, in the tags list, navigate to and hover over the name of the category you want to edit, and then select Edit.
- On the Edit Categories screen, complete one or both of the following steps:
- In the Name box, edit or retype the name of the category.
- In the Slug box, edit or retype the name of the slug.
- At the bottom of the screen, select Update.
Tags
Tags are standalone entities used for grouping specific post content.
Name tags
In WordPress, tags group related content together.
When creating tags, use the following naming convention:
[Module name – Heading name]Example: Lines – Configuration
For modules with additional layers of complexity, you have a couple of options:
- Add an extra name in the tag
- Use the identifier instead of the module name (as long as it’s unique to that module/product)
Example:
If you’re creating tags for content in this location:
- BriteApps > Policyholder portal > [Heading name]
Use one of the following naming formats:
- BriteApps – Policyholder portal – [Heading name]
- Policyholder portal – [Heading name]
The heading name is based on the headings for each section of documentation on either a Gen 2 or Gen 3 screen for a particular module (see example below).

Tag posts
Once you’ve created tags, you need to tag each post with the tag you created based on the section where the link is published on the site (see example below).

Based on our workflow, there are three places to add tags to your content:
- Google docs
- WordPress posts
- Tags screen
Note: You can create tags in all three locations but only tag content while using the WordPress.com for Google Docs add-on or editing a post in WordPress.
Add tags in Google Docs
In Google docs, you can use the WordPress.com for Google Docs add-on to add tags to post before importing it into WordPress.
To add tags in Google Docs:
- In Google Docs, open the document you want to add a tag to before you upload it to WordPress.
- Open the WordPress.com for Google Docs add-on.

- In the WordPress.com for Google Docs add-on, in the Tags box, type the name of the tag you want to add.
Note: Be sure you enter the exact name of the tag you created or want to create. If the tag names don’t match, the tag won’t work.

- To upload your content to WordPress with the tag, select Save.
Add tags to a post in WordPress
To add tags to a post in WordPress:
- On the WordPress dashboard, in the left sidebar, select Posts.
- On the Posts screen, navigate to and hover over the title of the post you want to add a tag to, and then select Edit.
Note: You can add tags in both the Block Editor and Classic Editor.
- In the right sidebar, in the Add New Tag box, complete one of the following steps:
- To add an existing tag, start typing the name of the tag you want to add, and then select it from the dropdown list that appears.
- To create and add a new tag, type the name of the tag you want to add, and then, when you’re ready, select either Save as Draft, Publish, or Update.


Add tags on the Tags screen
To add tags on the Tags screen:
- On the WordPress dashboard, in the left sidebar, hover over Posts, and then select Tags.
- On the Tags screen, complete the following steps:
- In the Name box, type the name of the tag.
Note: The slug is the URL-friendly version of the tag name. It’s usually all lowercase and contains only letters, numbers, and hyphens.
- In the Slug box, type the name of the slug.
Example: Tag name: Lines – Line items. Slug: lines-line-items.
- Skip the Description box.
Note: At this time, we do not have a reason to add descriptions to tags.
- Select Add New Tag.
- In the Name box, type the name of the tag.

Edit tags
Once you create a tag, you can always go back and edit it.
To edit tags:
- On the WordPress dashboard, in the left sidebar, hover over Posts, and then select Tags.
- On the Tags screen, in the tags list, navigate to and hover over the name of the tag you want to edit, and then select Edit.
- On the Edit Tag screen, complete one or both of the following steps:
- In the Name box, edit or retype the name of the tag.
- In the Slug box, edit or retype the name of the slug.
- At the bottom of the screen, select Update.