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.
- Download the Recap theme
.zipfile from your Pixel Themes purchase email. - In your Ghost admin, go to Settings → Design & branding.
- Click the Change theme button.
- Click Upload theme and select the Recap
.zipfile you downloaded. - 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.
Navigation
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
Search
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.
Social links
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)
- Bluesky
- Threads
- Mastodon
- TikTok
- YouTube
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.
Logo
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.
Copyright footer
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.
Featured carousel
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.
Related posts
At the bottom of each article, Recap shows related posts chosen by primary tag, to keep readers moving through your publication.
Footer
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.
Footer columns (secondary navigation)
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.
- Download the current Recap
.zipfrom your account or from Settings → Design & branding → Change theme → Downloaded themes. - Unzip and edit the source files. The
assets/folder contains the CSS and JavaScript source (compiled intoassets/built/); templates use the Handlebars format (.hbs), with reusable pieces inpartials/. - Recap builds assets with Gulp — run
npm install, thennpm run startfor development ornpm run prodto produce an upload-ready.zipin theproduction/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:
- Set your publication’s language under Settings → General → Language.
- Recap loads a matching locale file if one is available in
locales/. - To add a new language, create a
.jsonfile insidelocales/(e.g.,es.json) with translations for each key found inlocales/en.json.
Update theme
When a new version of Recap is released, you’ll receive an email with a download link. To update:
- Download the new
.zipfile. - Upload it via Settings → Design & branding → Change theme → Upload theme. Ghost will replace the older version.
- 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