Editorial conventions
Every internal tag Quiet reads, in one place. The ten homepage sections, the introduction layouts, the post and page opening layouts, the drop cap, the portfolio, podcast episodes, films and footer legal links. Read this first.
Quiet has no page builder and no long settings panel. Instead it reads a small vocabulary of internal tags: tags whose name starts with #. Put one on an ordinary Ghost page or post and the theme renders that content differently.
This page is the complete list. Each entry says what the tag does and links to the guide that walks through the setup, so you can scan here and read there.
Internal tags never show up for readers
Ghost treats a tag whose name starts with # as internal. It exists for your workflow: it is hidden from tag archives, from the public tag list and from the tags shown on a post. It still triggers theme behaviour, which is exactly what these are for. Add them in Post settings → Tags (or Page settings → Tags), the same way you add any tag.
How to add one
Open the page or post in the Ghost editor.
Click the settings icon at the top right, then find Tags.
Type the tag exactly as it appears on this page, including the #, and press Enter. Ghost creates it the first time you use it.
Publish or update. The change is live immediately.
Spelling counts
#home-intro works. #home_intro, home-intro and #Home-Intro do not. Ghost creates a brand new tag from a typo rather than warning you, and the section stays invisible.
The tags at a glance
Thirty-three tags, in five families.
Homepage sections (ten, on pages)
One tag per page. Each one turns that page into a band on your homepage.
| Tag | The band it becomes | Guide |
|---|---|---|
#home-intro | The introduction at the top, with your portrait | Introduction |
#home-hub | Topic tiles, built from the page's own tags | Topic tiles |
#home-latest | The Latest writing list | Latest writing |
#home-newsletter | The email signup band | Signup band |
#home-logos | A row of logos or press marks | Logo strip |
#home-testimonials | Quotes from readers or clients | Testimonials |
#home-podcast | Cover art and your three newest episodes | Podcast band |
#home-videos | Your three newest films | Video band |
#home-projects | Four projects as a numbered list | Portfolio band |
#home-gallery | A wide strip of photographs | Photo strip |
One section tag per page
A page carrying two #home-* tags renders only the first one Quiet finds, and the second band is simply missing. Give each section its own page.
Introduction layout and portrait shape (ten, on the #home-intro page)
These only ever go on the page that carries #home-intro. Full walkthrough: Introduction.
| Tag | What it does |
|---|---|
| (no tag) | The default: centred text with a round portrait above it |
#intro-split-left | Portrait on the left, words on the right |
#intro-split-right | Words on the left, portrait on the right |
#intro-panel-left | Full-height portrait panel on the left |
#intro-panel-right | Full-height portrait panel on the right |
#intro-ratio-square | Square portrait (the default is 4:5) |
#intro-ratio-3x4 | Slightly wider portrait |
#intro-ratio-2x3 | Taller portrait |
#intro-ratio-9x16 | Tallest portrait |
#intro-sharp | Square corners instead of the default soft ones |
#intro-round | A circle, when paired with #intro-ratio-square |
Two things to know about shapes
The four #intro-ratio-* tags and the two corner tags apply to the split layouts only. On a panel layout they do nothing, because the panel always fills its half of the screen. And #intro-round on a non-square portrait gives you an oval, so pair it with #intro-ratio-square for a circle.
Section switches (four)
Small opt-outs, each on the section page it belongs to.
| Tag | Put it on | What it does |
|---|---|---|
#intro-no-form | the #home-intro page | Removes the email signup field from the introduction, in every layout |
#hide-hub-counts | the #home-hub page | Removes the post count from each topic tile |
#logos-mono | the #home-logos page | Renders the logos in one muted colour instead of their own, and inverts them in dark mode |
#logos-static | the #home-logos page | Never animates the strip, even when there are more logos than fit |
Content tags (four)
These change what a page or post is, so they matter even if you never build a homepage section.
| Tag | Put it on | What it does |
|---|---|---|
#project | a page | Makes it a portfolio project |
#podcast | a post | Makes it a podcast episode |
#video | a post | Makes it a film |
#footer-legal-link | a page | Adds it to the small print row in the footer |
Post and page layouts (five, on posts and pages)
How a post or page opens. One layout tag per piece, and every picture layout needs a feature image; without one the piece opens with the default. Full walkthrough with pictures: Post and page layouts.
| Tag | What it does |
|---|---|
| (no tag) | The default: centred title, then the picture a little wider than the text |
#hero-split-left | A tall portrait crop of the picture on the left, the title beside it |
#hero-split-right | The same, mirrored: title left, portrait right |
#hero-full | Centred title, then the picture edge to edge |
#hero-inline | Centred title, then the picture at text width |
#dropcap | The article's first letter opens large, in the heading typeface |
Films keep their player
A post tagged #video opens with the film and ignores the layout tags. The side in a split tag's name is the side the picture sits on.
#project on a page
#projectTag a page #project and it becomes a portfolio entry: it joins the numbered index on your Projects page, it can appear in the homepage portfolio band, and it gains previous and next links so a visitor can walk your work in order.
What the page's own fields become is covered in Portfolio. One thing is worth repeating here, because it is the single most common surprise:
Put the category tag before #project
A project row shows a small category label above its name, and that label is the page's first tag. Ghost hides internal tags from readers but still counts them for position, so a page tagged #project, Photography shows no label at all. Tag it Photography, #project instead, in that order, and drag the tags in the editor if they are the wrong way round.
#podcast and #video on a post
#podcast#videoThese two tags sort your posts into three streams. An untagged post is writing, a post tagged #podcast is an episode, and a post tagged #video is a film.
| Untagged post | #podcast | #video | |
|---|---|---|---|
| Lives at | /your-slug/ | /podcast/your-slug/ | /videos/your-slug/ |
| Appears in | the article archive and Latest writing | the podcast page and the podcast band | the video channel and the video band |
| Extra treatment | none | an episode row with your own meta line | the film plays in a player at the top of the post |
Both streams need the routes file from Installation. Without it, /podcast/ and /videos/ do not exist and a tagged post is simply absent from your archive.
Tagging an existing post moves its address
A published post you now tag #podcast or #video changes URL, and Ghost does not leave a forwarding address. Anyone following an old link gets a 404. If the post has been shared, add the old and new paths to a redirects.json file in Settings → Labs → Redirects, using entries shaped like { "from": "/old-slug/", "to": "/podcast/old-slug/", "permanent": true }.
Never both tags on one post
A post tagged #podcast and #video is claimed by the podcast, so it disappears from the video channel and from your article archive at the same time. Pick one.
Full guides: The podcast and The video channel.
#footer-legal-link on a page
#footer-legal-linkTag a page #footer-legal-link and its title joins the small print row at the very bottom of your site, next to the copyright line. Privacy policy, terms, an imprint, a disclosure page: anything you want reachable from every page without spending a menu slot on it.
- The page title is the link text, so keep it short.
- The row orders by publish date, newest first.
- It holds up to twenty pages.
Footer legal link - Editor
Footer legal links
What is not an internal tag
Three things that look like they should be tags, and are not:
- Choosing a template. The Gallery, Newsletter, Contact and Projects layouts are picked from the Template dropdown in the editor's settings panel, not with a tag. See Pages you can build.
- Making something members-only. That is Ghost's Access setting in the editor. See Membership.
- Pinning a project to the top. That is Ghost's Featured star.
And your ordinary, reader-facing tags stay ordinary. Quiet uses them for the topic tiles, the archive filter row and project category labels, so tag your writing the way you always would.
Social links
The icon row in Quiet's footer: nine accounts from Ghost's own settings, an RSS button, and any other platform through two lines in code injection.
Homepage sections
How Quiet's homepage is assembled from ordinary Ghost pages, what each of the ten bands needs, and how the order is decided.