Build your homepage
A guided walkthrough from the starter layout to a composed homepage, one section at a time, ending with the exact page-and-tag recipe behind the Quiet demo site.
Quiet's homepage is a stack of bands, and each band is an ordinary Ghost page carrying one internal tag. There is no page builder and no drag-and-drop: you publish a page, tag it, and the band appears.
This walkthrough builds a homepage in the order most writers want it. Every step is optional except the first, and you can stop whenever the page says what you want it to say.
Before you start
Finish Installation first. You do not need the routes file for anything on this page, but you do need the theme activated.
Look at the starter homepage
Open your site. With no section pages published, Quiet shows a starter layout: your site title, your site description from Settings → General, and your most recent posts.

Nothing is broken. That layout is what a brand new site should look like, and it keeps working until you replace the top of it in the next step.
Publish the introduction
This is the one band worth doing properly, because it is the first thing a reader sees.
-
Go to Pages → New page.
-
Title it whatever your opening line should be, for example Essays on attention, craft and quiet work. The title becomes the large heading.
-
Write a paragraph or two in the body. That becomes the prose under the heading.
-
Open the settings panel and fill in the Excerpt with a short label, for example Writer and editor. It renders as one small line above the heading.
-
Set a Feature image. That becomes your portrait.
-
Under Tags, add this tag:
#home-intro -
Publish.
Reload your homepage. The starter title and description are gone, replaced by your introduction, with the recent-posts list still below it.
The introduction band in Ghost admin

The introduction band with a portrait

Portrait or plain text
The introduction shows a portrait beside or above the words whenever the page has a feature image. If you would rather have words alone, simply leave the feature image off. Four alternative layouts and four portrait shapes are covered in Introduction.
Add topic tiles
The topic band is the one section built from something you probably already have: your tags.
-
Tag your writing the way you normally would, and give each of those tags a description and an image in Settings → Tags. The tiles read all three.
-
Create a page. Title it Start anywhere or similar.
-
Under Tags, add this tag and the public tags you want as tiles:
#home-hub -
Publish.
The first four public tags become picture tiles. Any beyond the fourth line up underneath as a More topics row, so a page with nine tags shows four tiles and five links.
Topic tiles in Ghost admin

Topic tiles with a More topics row

Details, including how to drop the post counts: Topic tiles.
Decide about Latest writing
The recent-posts list you have seen since step 1 is a real band, and it keeps working with no page at all. Publish a #home-latest page only when you want to change something about it:
- The heading and the line under it. They come from the page's title, excerpt and body.
- Where it sits. Without a page the list stays near the top. With a page, it takes that page's place in the order.
- What it lists. Add a public tag to the page and the list narrows to that tag.
How many posts it shows is a setting rather than a tag: Home latest count, four, six or eight.
Episodes and films stay out
Latest writing lists your essays. Posts tagged #podcast or #video have their own bands and their own pages, so they never appear here.
Add the signup band
If memberships are on in Ghost, the introduction already has a signup field. A separate band gives email its own moment further down the page.
Create a page, add the tag #home-newsletter, and fill in as much as you want: title becomes the heading, excerpt becomes the small label above it, body replaces the default line of copy, and the meta description becomes the fine print under the field.
Readers who are already signed in never see this band, and neither does anyone if memberships are switched off.
Add the bands you actually need
The remaining six are all built the same way: one page, one tag, publish. None of them is required, and each one hides itself when it has nothing to show.
| Tag | The band | Feeds on |
|---|---|---|
#home-logos | A row of logos or press marks | Image cards in the page body |
#home-testimonials | Quotes with faces and stars | Ghost product cards in the page body |
#home-podcast | Cover art and three newest episodes | Posts tagged #podcast |
#home-videos | Three newest films | Posts tagged #video |
#home-projects | Four projects, numbered | Pages tagged #project |
#home-gallery | A wide strip of photographs | Image and gallery cards in the page body |
Each has its own short guide under Homepage sections.
Put the bands in the order you want
Quiet orders the bands by publish date, newest first, with one exception: the introduction is always pinned to the top.
So to move a band up, republish it with a more recent date. To move it down, set an older one. Ghost lets you edit the publish date of a published page in the settings panel under Publish date.
A quick way to plan the order
Publish the bands in reverse order, bottom of the page first. Each new page lands above the previous one, and you never have to edit a date.
Check the page on a phone
Two bands change shape on a small screen, and both are worth a look:
- Topic tiles become a row you swipe sideways.
- The photo strip and the logo strip drift slowly if there is more content than fits, with a pause button beside the heading. Neither animates for a visitor whose device asks for reduced motion.
Tidy up the section pages
Every section page is still a real page with its own address, so /start-anywhere/ renders on its own. That is occasionally useful and usually not what you want in search results. For each section page, open the settings panel, expand Meta data and turn on Exclude from search engines.
Leaving them indexed does no harm, and removing them from your menu is usually enough.
To remove a band
Unpublish the page, revert it to a draft, or delete the tag. The band disappears on the next page load, and nothing else on the homepage shifts except to close the gap.
Reproduce the demo site
This is the full recipe behind the Quiet demo, if you want to build the same thing to look at, or to check your install against something known.
The seven ordinary pages. These are the addresses your menu points at. Slugs matter for the first three, because the routes file binds them.
| Page title | Slug | Template | Fields the demo fills |
|---|---|---|---|
| Essays | articles | (default) | Title, excerpt |
| The Uncommon Way | podcast | (default) | Feature image as cover art, a public tag as the eyebrow, title, excerpt, a player embed in the body |
| The Desk | videos | (default) | Title, excerpt, a short intro in the body |
| Selected work | projects | Projects | Title, excerpt, a short intro in the body |
| Benches, hands and weather | gallery | Gallery | Title, a public tag, image and gallery cards in the body |
| A letter every other Sunday | newsletter | Newsletter | A public tag as the issue filter, title, excerpt, meta description |
| Say hello | contact | Contact | Title, excerpt, sidebar copy in the body |
The ten homepage bands. One page each, published oldest first so the stack ends up in this order on the page. The demo slugs them home-* to keep them together in the Pages list, but the slug is yours to choose.
| On the page | Page title in the demo | Slug | Tags |
|---|---|---|---|
| 1 | (the opening line itself) | home-intro | #home-intro, #intro-panel-left |
| 2 | Spoken at | home-logos | #home-logos, #logos-mono |
| 3 | Start anywhere | home-hub | #home-hub plus eight public tags |
| 4 | Videos | home-videos | #home-videos |
| 5 | Latest writing | home-latest | #home-latest |
| 6 | Praise | home-testimonials | #home-testimonials |
| 7 | Projects | home-projects | #home-projects |
| 8 | Podcast | home-podcast | #home-podcast |
| 9 | Photographs | home-gallery | #home-gallery |
| 10 | One idea, one thing I read, one thing I made | home-newsletter | #home-newsletter plus a public tag |
Three footer pages: Privacy, Terms, Rights and permissions, each tagged #footer-legal-link.
Six projects: pages slugged project-*, each tagged with its category first and #project second, one of them starred with Ghost's Featured toggle.
Posts: a dozen ordinary posts for the archive, three tagged #podcast, three tagged #video (each with a YouTube link or an uploaded video as the first card in the body), and one post set to Members only so you can see the padlocked card.
Tags: four to nine public tags, each with a description and an image, so the topic tiles have something to show.
Settings: an accent colour and a logo in Settings → Design & branding → Customize → Brand, memberships switched on, and the theme settings left at their defaults.
Routes: the file from Installation step 5, uploaded after pages 3, 4 and 13 exist.
Installation
Install Quiet in five steps: upload quiet.zip in Ghost Admin, activate it, publish the three section pages, and add the routes file that powers the archive, the podcast and the video channel.
Brand
Set your accent colour, logo, icon and fonts in Ghost's own Brand settings, and see exactly where Quiet uses each one.