Skip to content

Why your Ghost tag page returns 404

By Ahmad Ajmi

If your Ghost tag page shows “Page not found,” first check its URL and whether the tag has any published posts.

The tag URL

Open Tags in Ghost Admin and select the tag. Its Slug is the part used in the web address. Copy the URL beneath that field. Do not guess it from the display name. For example, the tag Photography can have the slug photography. Its URL is /tag/photography/.

Ghost Slug field containing photography with its public archive URL beneath it
Ghost shows the public archive URL directly beneath the tag’s slug.

Check that the tag is public. Internal tags begin with #. They help you organize content behind the scenes. They do not create public tag pages.

Open the copied URL in your browser. If it opens, update the menu or other link that led to the wrong address. If it still returns 404, check the posts assigned to the tag.

Published posts

A tag archive lists posts with that tag. In Ghost’s default routing, an archive with no published posts returns 404. See this Ghost Forum discussion.

Open Posts and choose the tag from the All tags menu. Read each post’s status. Drafts do not count as published content for the tag page. Nor do scheduled posts that have not gone live.

Ghost post row showing an unpublished example assigned to Photography and marked Draft
The assigned post shows Photography in its tag line and Draft as its status.

Once a tagged post is approved and published, open the copied tag URL again. The archive should list the post.

When published posts exist

In Ghost Admin, open a published post. Select Settings in the top-right corner, then check its tags. Make sure it has the public tag you checked. Open the post’s URL to see whether it is live on the website. If the copied tag URL still fails, ask the person who maintains your site about custom routing. These rules change which pages appear at certain addresses.

Ghost’s routing documentation explains these rules in routes.yaml. Send your site’s maintainer or hosting provider the tag URL and the URL of a published post with that tag. If you know whether the site uses custom routing, include that too.

More from the Blog

Latest Ghost Themes