Recap

v1.0.0

Setup and customization guide for the Recap Ghost theme.

Welcome to the Recap documentation. This guide covers everything you need to install, configure, and customize Recap — an editorial Ghost theme built for writers, cultural journals, and magazines with a strong voice.

Recap assumes a basic understanding of the Ghost platform. If you’re new to Ghost, we recommend the official Ghost Help Center before continuing.

Installation

You can install Recap directly from the Ghost admin panel.

  1. Download the Recap theme .zip file from your Pixel Themes purchase email.
  2. In your Ghost admin, go to Settings → Design & branding.
  3. Click the Change theme button.
  4. Click Upload theme and select the Recap .zip file you downloaded.
  5. Once uploaded, click Activate to enable Recap on your site.

You do not need to unzip the file — Ghost handles that automatically. The theme is now live.

Routes

Recap works with the default Ghost routing. No custom routes.yaml file is required. All standard Ghost routes are supported out of the box:

  • Home — /
  • Post — /{slug}/
  • Tag — /tag/{slug}/
  • Author — /author/{slug}/
  • Page — /{slug}/

If you customize routes, you can upload your own routes.yaml under Settings → Labs → Routes.

Recap uses Ghost’s built-in navigation, with two menus: Primary and Secondary.

Primary navigation

The primary menu appears in the header at the top of your site. Configure it in Settings → Navigation → Primary.

Add links in the order you want them shown. Each link accepts:

  • Label — the visible link text (e.g., Essays, About, Cinema)
  • URL — a full URL or a path like /about/

The active page’s menu item is highlighted automatically in your accent color.

Tag items and the mega menu

When a primary menu item points to a tag (for example Cinema → /tag/cinema/), Recap can turn it into a mega menu. On hover (or keyboard focus) the item opens a full-width panel showing that tag’s latest posts — each with its feature image and title — and a small chevron appears next to the label to signal it’s expandable.

  • Menu items that don’t point to a tag (Home, About, …) stay as plain links.
  • The posts shown are filtered by primary tag, so a post appears under the tag you set first in its tag list.
  • The mega menu can be switched off — see Enable mega menu.

Secondary navigation

Recap treats the secondary menu differently — it powers your footer columns. Add items with a [Column Name] prefix and Recap automatically groups them into columns under that heading.

For example, adding these entries in Secondary navigation:

  • [Topics] Cinema → /tag/cinema/
  • [Topics] Books → /tag/books/
  • [Company] About → /about/
  • [Company] Contact → /contact/

produces a footer with two columns: Topics (with Cinema and Books links) and Company (with About and Contact links). You can add up to three grouped columns — each new prefix creates a new column.

Items without a [Prefix] are rendered on the bottom bar, next to the copyright line — ideal for a single Sign up or legal link.

Basic settings

Recap integrates Ghost’s native search. The magnifying-glass icon in the header opens the search overlay, and readers can search across all posts, pages, tags, and authors.

Search is enabled by default and requires no configuration.

Dark mode toggle

The toggle in the header lets readers manually override their system color preference. Recap remembers the choice for future visits. See Dark mode for the related color and logo options.

Recap uses Ghost’s native social accounts — no extra theme fields. Add your publication’s profile URLs under Settings → Design & branding → Social accounts:

  • X (Twitter)
  • Facebook
  • LinkedIn
  • Bluesky
  • Threads
  • Mastodon
  • TikTok
  • YouTube
  • Instagram

Any account left empty is automatically hidden. The icons appear in the footer’s social list.

Author social links. Each author’s own accounts are set on their staff profile (Ghost admin → Settings → Staff → author) and can additionally include a Website. These appear on the author’s archive page. Authors are linked from each post’s byline.

Customization

Open Settings → Design & branding to access all customization options. Recap’s options are grouped under two tabs: Brand and Theme.

Accent color

Set your accent color under Brand → Accent color. This color is used for links, buttons, hover states, active menu items, and other interactive elements throughout your site.

Recap supports two separate accent colors — one for light mode and one for dark mode — so your brand stays legible in both. See Accent color for dark mode.

Recap displays your publication title in a script wordmark by default. If you upload a publication logo, it replaces the wordmark in the header and footer.

Upload your logo under Brand → Publication logo. Recap also supports a dark mode logo — see Logo for dark mode.

For best results:

  • Provide an SVG or a transparent PNG.
  • Recommended height: 40–60 px at 2× resolution.

Icon

Your publication icon (the favicon) is configured under Brand → Publication icon. Ghost automatically generates the various favicon sizes needed by modern browsers.

Recommended: 512×512 px PNG.

Typography

Recap ships with a curated typography stack designed for readability. No fonts need to be uploaded — the theme handles font loading efficiently. To change fonts, see the Edit theme section.

Site wide

These options live under Settings → Design & branding → Theme → Site wide and apply across your entire site.

Accent color for dark mode

Set a lighter or more saturated version of your accent color so it remains legible on a dark background. Default: #FFA71A.

Logo for dark mode

Upload a light-colored version of your logo to be shown when a reader switches to dark mode. If left empty, your standard logo (or the script wordmark) is used in both modes.

CTA heading

The headline shown in the homepage newsletter section. Make it a short, inviting line about what readers get by subscribing. Default: “Notes on cinema, books & philosophy.”

CTA description

The supporting sentence shown under the newsletter heading. Default: “Essays, reading notes and film readings — thoughtful writing on the ideas worth sitting with, delivered once a month.”

Enable mega menu

Turn the header mega menu on or off. When on (the default), primary menu items that link to a tag open a panel of that tag’s latest posts and show a chevron. When off, the header uses a simple text menu with no dropdowns. See Tag items and the mega menu.

Set the copyright line shown at the bottom of every page. You can use plain text or basic HTML — for example:

Published with <a href="https://ghost.org/" target="_blank" rel="noopener">Ghost</a>

The default shows your publication title with “Published with Ghost” and the current year. A custom line is recommended for branding.

Homepage

Recap’s homepage has three areas: a featured carousel, a recent posts grid, and a newsletter section.

Posts you mark as Featured in the Ghost editor (the star icon on the post) appear in a swipeable carousel at the top of the homepage. Each slide shows the feature image, primary tag, title, and excerpt.

  • The carousel is dependency-free — readers can use the arrows, the pagination dots, or swipe on touch and trackpad.
  • Up to the 10 most recent featured posts are shown.
  • If no posts are featured, the carousel is hidden and the grid moves up.

Recent posts grid

Below the carousel, Recap shows your latest posts in a three-column grid. Each card has the feature image, primary tag, title, and excerpt. As the reader scrolls, more posts load automatically (“load more” infinite scroll).

Members-only and paid posts display a “For subscribers” label, and featured posts show a “Featured” label.

Newsletter section

A full-width newsletter call-to-action closes the homepage, with an inline signup form. Its heading and description come from the CTA heading and CTA description settings. The section is shown only when memberships are enabled and the site is not invite-only.

Post

Split hero

Each article opens with a split hero: the title, excerpt, author avatars, date, and read time on the left, and the feature image at its natural size on the right (never cropped). On smaller screens the two stack. Posts without a feature image use a centered title block instead.

Metadata

The byline shows author avatars and names, the publish date, and the estimated read time. Read time is calculated automatically from the post’s word count.

Drop cap & typography

The first paragraph of every article opens with a large drop cap, and the body uses Recap’s refined reading typography with support for all of Ghost’s cards — Markdown, images, galleries, bookmarks, and more.

Labels

A “Featured” label appears on featured posts and a “For subscribers” label on members-only content, both in the header area and on post cards.

Share

Readers can share an article with the Share this post action, which opens Ghost’s native share options.

At the bottom of each article, Recap shows related posts chosen by primary tag, to keep readers moving through your publication.

Recap’s footer combines several configurable pieces.

Brand block

The left column shows your publication logo (or script wordmark), your publication description, and your social icons — all pulled from your Ghost settings, with no separate configuration.

Grouped link columns are built from the Secondary navigation menu using [Column Name] prefixes (up to three columns). See the Navigation section for details.

Bottom bar

The bottom bar shows your Copyright footer line on the left, and any unprefixed secondary-navigation links (such as Sign up) on the right.

Membership

Recap integrates fully with Ghost’s built-in membership system.

Portal

Portal is Ghost’s native sign-in and subscription flow. Recap is fully compatible — configure sign-up options under Settings → Membership → Portal settings. The Subscribe / Account button in the header and the homepage newsletter form both use Portal, and Recap follows your Portal button label and accent color for a consistent look.

Comments

Ghost’s native comments are supported on all post pages. Enable comments under Settings → Membership → Comments and choose whether comments are open to all members or only paid members.

Motion & performance

  • Scroll animations — content gently fades and lifts into view as readers scroll, and card images zoom slightly on hover. All motion is automatically disabled for visitors who have reduced motion enabled in their system settings.
  • Lazy images — images load as they approach the viewport with a soft blur-up effect, keeping pages fast.

No configuration is required for either.

Advanced

Edit theme

You can modify the theme source directly.

  1. Download the current Recap .zip from your account or from Settings → Design & branding → Change theme → Downloaded themes.
  2. Unzip and edit the source files. The assets/ folder contains the CSS and JavaScript source (compiled into assets/built/); templates use the Handlebars format (.hbs), with reusable pieces in partials/.
  3. Recap builds assets with Gulp — run npm install, then npm run start for development or npm run prod to produce an upload-ready .zip in the production/ folder.

Only advanced users should modify the theme source. Custom edits are not covered by our support.

Translate

Recap is translation-ready. To translate the theme:

  1. Set your publication’s language under Settings → General → Language.
  2. Recap loads a matching locale file if one is available in locales/.
  3. To add a new language, create a .json file inside locales/ (e.g., es.json) with translations for each key found in locales/en.json.

Update theme

When a new version of Recap is released, you’ll receive an email with a download link. To update:

  1. Download the new .zip file.
  2. Upload it via Settings → Design & branding → Change theme → Upload theme. Ghost will replace the older version.
  3. Your customizations (logos, colors, navigation, theme settings) are preserved. Direct edits to theme files are replaced — back them up first.

Feedback

Have a suggestion or want to report a bug? Contact us — we read every message.

Changelog

1.0.0 — 2026-10-26

  • Initial release