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.

1. Click in the Tags field
2. Start typing to see suggestions from your existing tags
3. Select a tag from the autocomplete or press Enter to create a new one
4. 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:

1. Type the tag name (max 25 characters)
2. Press Enter
3. 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.