Fix: Posts Not Showing on Tag Pages

Problem

Posts work with default theme but not with Story theme. This suggests the `` helper might not be working correctly.

Solution: Use Alternative Approach

Since posts work with default theme, let’s try a simpler approach that doesn’t rely on helper. However, Ghost's tag.hbs template doesn't have direct access to posts, so we need the helper.

Debug Steps

  1. Check if debug message appears:
    • Go to tag page
    • Do you see “No chapters found” with debug info?
    • If yes → `` is running but finding no posts
    • If no → Template might not be loading
  2. Check browser console:
    • Press F12
    • Look for JavaScript errors
    • Check if CSS is loading
  3. Verify theme is active:
    • Settings → Design
    • Make sure “Story Theme” is Active (not the built-in one)

Remove Built-in Theme

The built-in theme is likely in the Ghost Docker image. To remove it:

cd ghost-theme

# Access container
docker-compose exec ghost bash

# Remove built-in theme
rm -rf /var/lib/ghost/content/themes/story-theme

# Exit
exit

# Restart
docker-compose restart ghost

OR fresh start (removes everything):

docker-compose down -v
docker-compose up -d

Then upload only YOUR theme.

Alternative: Check Filter Syntax

The filter might need to be different. Try these variations:

  1. filter="tags:"
  2. filter="tags.slug:"
  3. filter="tag:" (singular)

Let me update the template to try a different approach.


© 2025, Ramin Firoozye. All rights reserved.