Skip to content
Guide

Evergreen documentation

An immersive photo journal: a full-bleed opening photograph, a featured panel, and a journal told along a timeline whose composition changes at every entry.

Installation

  1. Download evergreen-package.zip from your purchase email or your purchases library and unzip it: it contains evergreen.zip (the theme), evergreen-demo.zip (the demo content), a README and the licence. Do not unzip evergreen.zip.
  2. In Ghost Admin, open Settings → Design & branding → Change theme.
  3. Click Upload theme, select the zip, then Activate.

Evergreen requires Ghost 6 (self-hosted, or a Ghost(Pro) plan that allows custom themes).

Updating

Upload the new zip the same way and confirm the overwrite. Your content, navigation and theme settings are kept.

Import the demo content

The download includes evergreen-demo.zip: posts, pages, tags, navigation and images.

  1. Use a new or empty site: importing over existing content creates duplicates. On a fresh Ghost, first delete the default content in Settings → Advanced → Danger zone → Delete all content.
  2. Open Settings → Advanced → Import/Export and import the zip (not just the JSON, or the images will be missing).
  3. Theme settings are not part of an import: set them in Design & branding (see the table below).

Homepage sections

SectionContent comes from
HeroThe publication cover (Design & branding → Brand), or the latest Featured image, with Hero statement and the site description. Add the photo credit in Hero credit.
Featured panelThe latest post marked Featured, overlapping the photo.
JournalThe 4 latest posts of Journal tag, in four alternating compositions along a timeline.
PlacesThe 3 latest posts of Places tag: one tall photo and two stacked. The post already in the featured panel is skipped.
PeopleThree portraits from People tag. The post title is the person’s name; write the excerpt as Role — quote.
IdeasThe 4 latest essays of Ideas tag, text only.

Each section hides itself when its tag does not exist or is empty. Above titles, the theme shows the first public tag that is not the section’s own tag: give each post a secondary tag (a country, a theme).

Photography page

The tag whose slug is set in Photography tag (default photography) is shown as a photo mosaic; every other tag keeps the timeline. The tag’s name is free.

Appearance

Cream (default), Forest night or Auto. The header is transparent over opening photos: a light logo, or the text title, reads best. Fonts: Libre Caslon Display, Libre Caslon Text and Jost.

All settings

SettingTabDefaultWhat it does
Color schemeSite-wideLightDefault color scheme: Light (cream) or Dark (forest night). Readers can switch.
Photography tagSite-widephotographySlug of the tag whose page is shown as a photo mosaic (e.g. photography)
Other social linksSite-wide—Extra social profile URLs, comma-separated (Pinterest, WhatsApp, GitHub...)
Show newsletterSite-wideOnSubscription band (forest green) at the bottom of every page
Newsletter headingSite-wideLetters from a slower lifeHeading of the subscription band
Newsletter textSite-wideOne story, one place and one thing worth making, delivered twice a month. Nothing more.Text of the subscription band
Show heroHomepageOnFull-width photo (publication cover, or latest Featured image) with a statement
Hero statementHomepageStories for a slower life.Large statement over the hero photo
Hero creditHomepage—Credit of the hero photo, e.g. Photo by Jane Doe / Unsplash
Show featured panelHomepageOnPanel with the latest post marked as Featured, over the hero's bottom edge
Show journalHomepageOnJournal: four latest posts of a tag, in four compositions along a timeline
Journal tagHomepagejournalSlug of the journal tag (empty = latest posts of any tag)
Show placesHomepageOnPlaces: three latest posts of a tag, one tall photo and two stacked
Places tagHomepageplacesSlug of the places tag
Show peopleHomepageOnPeople: three portraits. Excerpt format: Role — quote
People tagHomepagepeopleSlug of the people tag
Show ideasHomepageOnIdeas: four latest essays of a tag, text only, on a sage band
Ideas tagHomepageideasSlug of the ideas tag
Table of contentsPostOnShow a table of contents on posts with three or more headings

Posts per page: 8 (set by the theme). Settings are in Settings → Design & branding → Customize, in the Site-wide, Homepage and Post tabs.

  • Dropdowns: in Settings → Navigation, start a label with a dash (-About) to put it in a dropdown under the item above. That parent item only opens the dropdown; its URL is not used.
  • Social accounts: X, Facebook, LinkedIn, Bluesky, Threads, Mastodon, TikTok, YouTube and Instagram come from Settings → General → Social accounts. Add any other profile in the Other social links setting (comma-separated URLs): Pinterest, WhatsApp, Telegram, Discord, GitHub, Dribbble, Behance, Spotify, Twitch, Snapchat, Reddit and Medium get their icon, any other URL gets a link icon.
  • The RSS icon is added automatically.

Posts & pages

  • Table of contents: added automatically to posts with three or more H2 headings (setting Table of contents).
  • Full width page template: choose it in the page settings for landing pages.
  • Sharing: posts end with the theme’s share links and a last button that opens Ghost’s own share window, with more networks and email (Ghost 6 from April 2026; on older versions the button does nothing).
  • The page option Show title and feature image is respected.
  • Every editor card is styled, including wide and full-width images, galleries, toggles, callouts, buttons and bookmarks.
  • Enlarge images: readers click an image or a gallery image of a post or page to see it full screen (zoom with a double-click or the wheel, arrows between images, Escape or a swipe down to close). An image that has a link keeps its link.

Members & newsletter

The subscription block uses Ghost’s native members. It is hidden for signed-in members, and when sign-ups are off or invite-only (Settings → Membership).

Recommendations

Sites you recommend in Settings → Growth → Recommendations appear in a strip at the bottom of the footer (five at most), with a See all button that opens the full list. Turn recommendations off and the strip disappears.

Translation

Every text of the theme goes through Ghost’s translation system. Copy locales/en.json inside the theme to locales/fr.json (or your language code), translate the values, zip the theme again and upload it. Then set the language in Settings → General → Publication language.

FAQ

My logo is hard to read on the homepage photo.

The header is transparent over the photo: use a light version of your logo, or remove it to show the site title.

A section of the homepage does not appear.

Check its switch in Design & branding, then its content: every section hides itself when it has nothing to show (no Featured post, no post with the internal tag, an empty tag…).

Can I change the fonts?

Yes: the fonts chosen in Design & branding → Typography replace the theme’s heading and body fonts.

Changelog

Current version: 1.1.1. Updates are free: download the new package from your Gumroad library and upload its evergreen.zip as in Installation; your settings are kept.

  • 1.1.1 (28 October 2026): Comments stay readable in dark mode (no white box behind them) and follow the light/dark switch without reloading the page.
  • 1.1.0 (25 October 2026): Recommendations strip in the footer (sites you recommend in Ghost, with "See all"); images and gallery images of posts and pages open full screen (zoom, arrows, swipe to close); "(Page 2)" in the title of paginated pages; main script preloaded.
  • 1.0.2 (22 October 2026): Native Ghost share button (#/share) after the share links; author name in the author card is a heading; comment link labelled when a post has no comments yet; descriptions over images and colour blocks at full contrast.
  • 1.0.1: Added this README.
  • 1.0.0: First release.