Internal Tags
Most of what makes Wire different is switched on by tagging content. Ghost treats any
tag starting with # as internal: it changes how the theme behaves, but it never appears on
the site and never gets its own tag page.
How to add one#
- Open the post or page
- Click Post settings (the gear icon) or Page settings
- In the Tags field type the tag including the
#, for example#breaking - Press Enter and publish or update
A post can carry as many internal tags as you need alongside its normal public tags.
Tags for posts#
| Tag | What it does |
|---|---|
#breaking | The three newest posts with this tag scroll in the bar above the header. See Breaking News Bar |
#spotlight | The newest post with this tag becomes the Spotlight card in the sidebar. Without one the theme falls back to a featured post |
#project | Adds the post to the Projects page and the Projects widget. See Projects |
#sponsor | Adds the post to the Sponsors widget. The feature image is the logo and custom_excerpt is the outbound link |
#newsletter | Moves the post out of the homepage feed and the Blog page into the newsletter archive. See Newsletters |
#audio | Lifts the first audio card of the body into the feature media and turns on the sticky player. See Audio Post |
#audio-preview | Marks the post's cards with a small audio badge |
#video | Lifts the first video or embed of the body into the feature media and turns on the sticky player. See Video Post |
#video-preview | The post's cards play that video, muted, when the card scrolls into view. See Video Preview |
#toc | Forces the table of contents on this post, even when the toc feature is off |
#drop-cap | Drop cap on this post only. The drop-caps feature does it site wide |
Tags for pages#
| Tag | What it does |
|---|---|
#home-section | Turns the page into a homepage section. The page slug has to match a public tag slug. See Custom Sections |
#toc | Adds the table of contents to the page. Pages never show it otherwise |
#home-hero-show-subscription | On the home-hero page: the hero call to action is a subscribe form |
#home-hero-show-button | On the home-hero page: the call to action is the sign-up button |
#home-hero-show-social-links | On the home-hero page: the call to action is your social links |
#home-hero-align-center | On the home-hero page: centers the hero content |
The three home-hero-show-* tags are mutually exclusive — the theme uses the first one it
finds. See Hero.
Public tags with a special meaning#
One naming rule is not an internal tag, because these tags are meant to be seen:
| Slug pattern | What it does |
|---|---|
issue-* | A tag whose slug starts with issue- (for example issue-01) is an edition. It gets a place on the Issues page, a card in the homepage Editions carousel and a "More from this issue" rail at the end of every post in it. See Issues |
Edition tags are deliberately kept out of the ordinary tag lists — the Tags page, the homepage tag carousel and the tag filters all skip them — so a long run of issues never crowds out your real sections.
Pages recognised by slug#
Some pages are picked up by their URL rather than by a tag. Create the page, set the slug in Page settings → Page URL, and the theme does the rest.
| Slug | What it becomes |
|---|---|
home-hero | The content of the Hero cover |
house-ad | The house ad in the sidebar |
membership | The pricing page. See Membership |
subscribe | A centered page with a subscribe form |
signin / account | Sign-in and account pages wired to Ghost Portal |
recommendations | Your Ghost recommendations |
tags | The Tags directory |
authors | The Authors directory |
projects | Optional. When it exists, the Projects widget heading becomes a link |
sponsors | Optional. When it exists, the Sponsors widget heading becomes a link |