Theme settings guide
Dispatch, setting by setting.
Build an independent newspaper with three front-page layouts, a curated Most Popular box and an editorial carousel. This guide explains every control in Dispatch 1.1.1, its default and where it appears.
Where the settings live
Activate Dispatch, then open its theme controls in Ghost Admin:
Settings→Design & branding→Customize→Theme
Six settings are grouped under Homepage; the other fourteen are under Site wide. Dispatch has no separate Post settings group. Preview your changes and press Save to publish them. The panel’s wording may vary with your Ghost version; see Ghost’s design settings guide.
Your publication title, logo, icon and accent colour are Ghost’s own Brand settings. They are separate from the twenty controls below.
First hour
- Set your brand. Upload a light logo for the dark masthead and footer, a square publication icon, and choose your accent colour.
- Add section links. Primary navigation fills the header and slide-out menu. Secondary navigation fills the footer.
- Feature two stories. Enable Feature this post in their post settings to populate the default Classic hero row.
- Curate Most Popular. Give selected posts the internal tag #popular. Leave Most popular tag at hash-popular.
- Choose carousel content. Tag posts cartoons, change Carousel tag to another tag slug, or clear it to disable the block. Set a descriptive Carousel title.
- Replace demo wording. Review Newsletter title, Newsletter text, Footer tagline and Compact logo text, then enter your own social profile URLs.
- Check the publication as a reader. Review the homepage, one tag page, one article and signup while signed out. Enable memberships if you want newsletter boxes and Subscribe links.
For the upload and update workflow, see installation instructions. Dispatch requires Ghost 5.0 or later and a hosting plan that allows custom themes.
All twenty settings
Each entry gives the control’s label, internal key, type and default. Tag fields take a slug, rather than the tag’s display name or URL.
Homepage
Six controls for the homepage’s editorial package.
Classic starts with the two newest featured posts. With one featured post, it spans the row; with none, that hero row is skipped. Lead and headlines puts one lead beside four recent headlines. Single lead uses one wide hero. The latter two layouts prioritise featured posts, then publication date.
Where it appears: The top of the homepage.
The grids, newsletter band, lower hero, carousel and compact rows follow the opening package when content is available.
Masthead uses a large centred publication logo and a section navigation bar on the homepage. Compact uses the slim header everywhere.
Where it appears: The homepage header.
Other pages always use the slim header. In Masthead mode it also appears as you scroll down the homepage.
Shows the editorially curated Most Popular box when posts match Most popular tag. This is a selection you maintain with a tag, rather than an automatic traffic ranking.
Where it appears: The homepage story grid.
The box is shown on desktop and phones, and hidden at tablet widths of roughly 768–1100 px.
Enter the tag slug used to select up to five posts. The default hash-popular is the slug Ghost gives the internal tag #popular. Matching posts are listed newest first.
Where it appears: The Most Popular box.
The box stays hidden until at least one published post has that tag. Show most popular must also be on.
Enter the tag slug for the carousel, for example cartoons or photo-essays. It displays up to six published posts, newest first. Clear this field to disable the carousel.
Where it appears: Beside the lower hero story on the homepage.
Posts in this tag are excluded from the regular homepage grids and Load more feed. In Classic, featured posts can still appear in the top hero row.
Sets the label above the carousel and its accessible name. Use a short description of its contents, such as Photo essays, Cartoons or Video.
Where it appears: The homepage carousel.
When blank, the visible label uses the tag’s name. Keep a descriptive title set so the carousel also has an accessible name.
Site wide
Fourteen controls for branding, newsletter boxes, social links and archive layouts.
The heading shared by the newsletter signup boxes. Replace the default with wording that suits your publication.
Where it appears: Newsletter boxes on the homepage, tag pages, author pages and articles.
Keep a meaningful heading: it also supplies the signup region’s accessible name.
The short invitation beneath the newsletter heading. Explain what readers will receive and, if useful, how often.
Where it appears: All newsletter signup boxes.
The form button and confirmation messages are translated theme wording, rather than part of this setting.
A short text mark used when no publication icon has been uploaded. Change D to your own initial or short abbreviation.
Where it appears: The slim header.
A publication icon set in Ghost’s Brand settings takes priority. The full masthead uses the publication logo or title instead.
Reserves empty spaces for advertising on tag/section pages. The theme does not supply ads or an ad network integration.
Where it appears: Above the section feed and after stories 3, 7 and 11 on its first page.
Add your own integration through Code Injection, targeting .ad-slot. Leave this off until you have an integration ready to avoid empty gaps.
Your full Instagram profile URL. An icon is shown only when a URL is entered.
Where it appears: The masthead, slide-out menu and footer social links.
Leave blank to omit Instagram.
Your full YouTube channel URL. An icon is shown only when a URL is entered.
Where it appears: The masthead, slide-out menu and footer social links.
Leave blank to omit YouTube.
Your full TikTok profile URL. An icon is shown only when a URL is entered.
Where it appears: The masthead, slide-out menu and footer social links.
Leave blank to omit TikTok.
Your full Threads profile URL. An icon is shown only when a URL is entered.
Where it appears: The masthead, slide-out menu and footer social links.
Leave blank to omit Threads.
Your full Bluesky profile URL. An icon is shown only when a URL is entered.
Where it appears: The masthead, slide-out menu and footer social links.
Leave blank to omit Bluesky. Facebook and X use Ghost’s own Social accounts settings.
One switch for the newsletter signup boxes throughout the theme. Memberships must also be enabled in Ghost.
Where it appears: The homepage band, tag and author feeds, and the end of articles.
Boxes are hidden from signed-in members. This switch does not remove the header’s Sign in or Subscribe links, which follow Ghost’s membership settings.
Large stories gives each story a large image, byline, date, excerpt, reading time and share tools. Compact list puts a thumbnail beside the headline and excerpt for shorter archive pages.
Where it appears: Tag/section pages and author pages.
The homepage layout is controlled separately.
Sans-serif uses bundled Archivo for story headlines and article headings. Serif uses Lora instead.
Where it appears: Story headlines and headings within articles.
A heading font selected in Ghost’s Typography settings takes priority. Leave it on Theme default to use this choice.
No setting matches that search. Clear the box to see all twenty.
How the homepage builds
The homepage uses published posts, their Featured status and your two content tags. Empty blocks hide themselves. A publication with no published posts shows “No stories yet”.
| Area | Selection |
|---|---|
| Classic heroes | The two newest featured posts. One fills the row; none removes the row. Additional featured posts are not added to the regular Classic grids. |
| Lead and headlines / Single lead | Featured posts first, then publication date, excluding the carousel tag. With no featured posts, the newest eligible story leads. |
| Story grids and compact rows | Remaining eligible stories, with carousel-tagged posts excluded. Load more skips posts already displayed. |
| Most Popular | Up to five posts carrying the selected tag, newest first. It is curated with tags, not calculated from views. |
| Carousel | Up to six posts carrying Carousel tag. Images are contained rather than cropped, so illustrations and cartoons can retain their whole composition. |
Use #popular as an internal tag in the editor, but enter its slug hash-popular in the setting. For a public tag named Photo essays, use its actual slug, such as photo-essays.
Branding and navigation
Logos and colour
The masthead and footer are dark, so use a light or white publication logo. The slide-out menu is white: upload a dark version in Menu logo, or let the theme darken your publication logo. Without a logo, your publication title is used.
The slim header uses your publication icon, falling back to Compact logo text. Set the accent colour in Ghost’s Brand settings. It colours labels, rules, buttons and the Membership navigation item; the theme adjusts text and button shades when needed for contrast.
Fonts
Archivo, Figtree and Lora are bundled with Dispatch. Headline font changes story headlines and article headings. Custom fonts chosen in Ghost’s Typography settings take priority and are loaded by Ghost.
Menus and social profiles
Primary navigation supplies the section menus. An item labelled Membership is highlighted in the accent colour. Secondary navigation supplies the footer links. Instagram, YouTube, TikTok, Threads and Bluesky use theme settings; Facebook and X use Ghost’s own Social accounts settings. Leave unused profile fields blank.
Sections, authors and optional routes
A public tag becomes a section page. Tags with a shared slug prefix become sub-section links: politics-elections appears under politics. Up to twelve matching tags are shown, with a More menu on phones.
Section layout controls both tag and author feeds. Author names, biographies, photos and locations come from the staff profile in Ghost Admin. A newsletter box can appear after the third story.
The bundled routes.yaml is optional
Ghost’s default section URLs are /tag/{slug}/. The supplied routes file moves every tag archive to /news/{slug}/ and adds /news/ for posts tagged news. The news tag’s archive is then /news/news/.
Download your current routes file as a backup before uploading the supplied one under Ghost’s Settings → Labs → Routes. Update navigation and existing links, and add redirects for public URLs that change. Keep the default routes if you prefer /tag/… URLs; no custom routing is needed for the theme settings to work.
Recommended image sizes
| Image | Recommended |
|---|---|
| Feature images | Landscape photographs at least 1600 px wide. Cards and Classic heroes crop to 3:2; large section stories use about 16:9 on desktop and 3:2 on phones. Keep the subject near the centre. |
| Carousel images | Any aspect ratio. The whole image is fitted inside a dark panel. |
| Author photos | Square, at least 300 × 300 px, set in the author’s staff profile. |
| Publication and menu logos | SVG or transparent PNG. Use a light publication logo and a dark menu logo; review both at their displayed size. |
Ghost generates widths of 160, 320, 600, 1000 and 2000 px from your uploads. A story without a feature image uses a plain dark placeholder.
Members and articles
Dispatch uses Ghost’s native memberships, Portal, search and comments. Enable memberships in Ghost Admin to show signup and account controls; paid memberships also require your own payment configuration.
- Newsletter boxes require memberships and Show newsletter boxes. Signed-in members do not see them.
- Restricted stories show lock badges in listings. Ghost handles access to members-only and paid content.
- Articles use the primary tag, custom excerpt, author information and feature-image caption from the post editor. Related stories appear under Keep reading, using the primary tag; untagged posts fall back to recent stories.
- Comments appear when enabled in Ghost.
- Editor content supports regular, wide and full-width images, galleries, callouts, toggles, bookmarks, buttons, tables, code and embeds.
Updates, wording and small changes
Before an update, download your current theme and keep a content backup. Upload the new Dispatch ZIP, preview representative pages and activate it. Existing theme settings are retained. Direct edits to theme files need to be copied into the new version.
Use Code Injection for small CSS changes or your own ad integration. Show ad slots reserves space only; it does not load ads. The theme ships no ad provider or cookie banner.
Fixed labels and form feedback are in locales/en.json. Edit those values to change wording, or copy the file to a language code such as fr.json, translate it and select that publication language in Ghost. Newsletter heading and description are controlled by the theme settings above.
Troubleshooting
The settings panel is missing
Dispatch must be active, not just uploaded. Activate it under Design & branding, then reopen Customize → Theme. This guide covers version 1.1.1; update an older copy if a listed control is absent.
The Classic homepage has no hero stories
Feature at least one published post in its post settings. Classic only uses the newest two featured posts for the top row; the other layouts can lead with a recent unfeatured story.
Most Popular is missing
Turn on Show most popular, tag at least one published post #popular and leave the setting at hash-popular. The box is deliberately hidden at tablet widths.
The carousel is missing or stories disappeared from the grids
Carousel tag must contain the correct slug and match a published post. Those posts are reserved for the carousel and excluded from regular grids. Clear the setting to disable that selection.
Newsletter boxes are missing
Enable memberships and Show newsletter boxes, then test while signed out. Signed-in members do not see signup boxes. Check that a tag or author feed has at least three stories for its inline box.
Section links return 404 after changing routes
The optional routes file moves tag archives from /tag/… to /news/…. Update your links or restore your previous routes file.
The menu logo or footer tagline is missing
Use a dark Menu logo for the white menu panel. The footer’s publication-logo block and tagline are intentionally hidden at tablet and phone widths.
There are empty advertising gaps
Show ad slots reserves space without filling it. Turn it off until your ad integration is ready.
Still stuck?
Email [email protected] with your Ghost version, Dispatch version, page URL and the setting you need help with. Support covers installation, documented settings and confirmed theme defects.
See the Dispatch product page or the installation and update guide.