Tags
Tags help you organize your content and make it easier for readers to find related articles on your blog.
How tags work
When you add tags to your posts, they serve multiple purposes:
- Organization – Group related content together
- Discovery – Readers can browse all posts with a specific tag
- SEO – Tags appear in your page metadata
- Navigation – Each tag gets its own page at
/tags/tag-name
Adding tags to posts
When editing a post, you'll find the Tags field in the right sidebar.
- Click in the Tags field
- Start typing to see suggestions from your existing tags
- Select a tag from the autocomplete or press Enter to create a new one
- Remove tags by clicking the X icon on each tag
Autocomplete suggestions
As you type, the system suggests tags you've already used. Each suggestion shows:
- The tag name
- How many times you've used it
This helps you reuse existing tags and avoid typos or duplicates like "JavaScript" and "javascript".
Creating new tags
If you want to create a tag that doesn't exist yet:
- Type the tag name (max 25 characters)
- Press Enter
- The tag is added to your post and saved to your blog
Tag naming guidelines
- Keep tags concise (max 25 characters)
- Use consistent capitalization
- Avoid duplicates with different spellings
- Check autocomplete suggestions before creating new tags
Tag pages on your blog
Every tag automatically gets its own page where readers can browse all posts with that tag.
URL format: yourblog.com/tags/tag-name
For example, if you tag posts with "JavaScript", readers can visit:
yourblog.com/tags/javascript
Tag pages:
- Show all published posts with that tag
- Are sorted by publication date (newest first)
- Include pagination if there are many posts
- Display in your blog's active theme
- Are indexed by search engines
Managing your tags
Go to Settings → Tags to see all your tags and their statistics.
What you can see
- Total tags – How many unique tags you've created
- Tag list – All tags with their usage count
- Orphaned tags – Tags used only once (possibly typos)
Tag statistics
For each tag, you can view:
- Name – The display name
- Slug – The URL-friendly version
- Usage count – How many posts use this tag
- Status – Whether it's orphaned (used only once)
Finding typos and duplicates
The tags page highlights orphaned tags – those used only once. These often indicate typos or accidental variations.
For example, if you see:
- "javascript" (used 10 times)
- "javascrpt" (used 1 time) ← orphaned
The orphaned tag is likely a typo. You can view which post uses it and correct it.
Tag display in themes
Tags appear automatically in your blog's theme:
On post pages:
- Tags are shown as clickable badges or links
- Clicking a tag takes readers to that tag's page
On tag pages:
- Theme-specific layouts (Terminal, Minimalist, Notion, etc.)
- Title showing the tag name
- Count of articles with that tag
- List of matching posts with pagination
Different themes style tags differently, but all support the same functionality.
Best practices
Be consistent Use the same capitalization and spelling. The autocomplete helps with this.
Don't over-tag Use 3-5 relevant tags per post. Too many tags dilute their usefulness.
Think about readers Use tags readers would search for, not just internal organization terms.
Review regularly Check your tags page occasionally to spot and fix typos or unused tags.
Merge when needed If you have similar tags like "JS" and "JavaScript", stick to one and update older posts.
Technical details
Tag slugs When you create a tag, the system automatically generates a URL-friendly slug:
- Converted to lowercase
- Spaces replaced with hyphens
- Special characters handled (e.g., "C++" becomes "c-plus-plus")
Tag scope Each blog has its own tags. You won't see tags from other blogs in your autocomplete.
Tag persistence Tags remain in your blog even if no posts use them currently. This preserves the tag for future use.
SEO impact Tag pages are indexed by search engines, potentially bringing traffic to your blog through tag-based searches.