Use: {{#is "tag"}}{{/is}}
to detect this context
tag
context when viewing the page thats lists all posts with that tag, as well as subsequent pages of posts. The tag
context is not set on posts or pages with tags, only on the list of posts for that tag.
/tag/:slug/
. The tag
context is also set on subsequent pages of the post list, which live at /tag/:slug/page/:num/
. The slug
part of the URL is based on the name of the tag and can be configured from the Tags page in Admin. To change the tag URL structure, use routing.
index.hbs
— or an optional tag.hbs
template can be used.
To provide a custom template for a specific tag, use tag-:slug.hbs
where the :slug
matches the tag’s slug.
For example, if you have a tag ‘photo’ with the url /tag/photo/
, adding a template called tag-photo.hbs
will cause that template to be used for the photo tag instead of tag.hbs
, or index.hbs
.
These templates exist in a hierarchy. Ghost looks for a template which matches the slug (tag-:slug.hbs
) first, then looks for tag.hbs
and finally uses index.hbs
if neither is available.
tag
context, a template gets access to 3 objects: the tag object which matches the route, an array of post objects and a pagination object. As with all contexts, all of the @site
global data is also available.
{{#tag}}{{/tag}}
) to drop into the tag scope and access all of the attributes.
{{#foreach 'posts'}}{{/foreach}}
. The template code inside the block will be rendered for each post, and have access to all of the post object attributes.
{{#tag}}{{/tag}}
block expression is useful for accessing all attributes. Once inside the tag, use helpers like {{img_url}}
and {{url}}
to output the tag’s details.
Using {{#foreach 'posts'}}{{/foreach}}
is the best way to loop through the list of posts and output each one. If you’re using the Members feature, consider the content visibility of your posts
If your theme does have a tag.hbs
and author.hbs
file all outputting similar post lists to index.hbs
you may wish to use a partial to define your post list item, for example: {{> "loop"}}
.