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.

20 theme settingsGhost 5+ requiredLive demo

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

  1. Set your brand. Upload a light logo for the dark masthead and footer, a square publication icon, and choose your accent colour.
  2. Add section links. Primary navigation fills the header and slide-out menu. Secondary navigation fills the footer.
  3. Feature two stories. Enable Feature this post in their post settings to populate the default Classic hero row.
  4. Curate Most Popular. Give selected posts the internal tag #popular. Leave Most popular tag at hash-popular.
  5. 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.
  6. Replace demo wording. Review Newsletter title, Newsletter text, Footer tagline and Compact logo text, then enter your own social profile URLs.
  7. 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.

Homepage layouthomepage_layoutSelectClassic by default

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.

Header styleheader_styleSelectMasthead by default

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.

Site wide

Fourteen controls for branding, newsletter boxes, social links and archive layouts.

Newsletter titlenewsletter_titleTextSubscribe by default

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.

Newsletter textnewsletter_textTextStay up to date, join our newsletter. by default

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.

Compact logo textcompact_logo_textTextD by default

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.

Show ad slotsshow_ad_slotsToggleOff by default

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.

Instagram URLinstagram_urlTextBlank by default

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.

YouTube URLyoutube_urlTextBlank by default

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.

TikTok URLtiktok_urlTextBlank by default

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.

Threads URLthreads_urlTextBlank by default

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.

Bluesky URLbluesky_urlTextBlank by default

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.

Show newsletter boxesshow_newsletter_boxesToggleOn by default

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.

Section layoutsection_layoutSelectLarge stories by default

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.

Headline fontheadline_fontSelectSans-serif by default

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.

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”.

AreaSelection
Classic heroesThe 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 leadFeatured posts first, then publication date, excluding the carousel tag. With no featured posts, the newest eligible story leads.
Story grids and compact rowsRemaining eligible stories, with carousel-tagged posts excluded. Load more skips posts already displayed.
Most PopularUp to five posts carrying the selected tag, newest first. It is curated with tags, not calculated from views.
CarouselUp 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

ImageRecommended
Feature imagesLandscape 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 imagesAny aspect ratio. The whole image is fitted inside a dark panel.
Author photosSquare, at least 300 × 300 px, set in the author’s staff profile.
Publication and menu logosSVG 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.