Gazette documentation
A colourful lifestyle blog: a large slider of your Featured stories, then the latest stories next to a sidebar that introduces you, a quote of the week and your writers.
Installation
- Download
gazette-package.zipfrom your purchase email or your purchases library and unzip it: it containsgazette.zip(the theme),gazette-demo.zip(the demo content), a README and the licence. Do not unzipgazette.zip. - In Ghost Admin, open Settings → Design & branding → Change theme.
- Click Upload theme, select the zip, then Activate.
Gazette 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 gazette-demo.zip: posts, pages, tags, navigation and images.
- 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.
- Open Settings → Advanced → Import/Export and import the zip (not just the JSON, or the images will be missing).
- Theme settings are not part of an import: set them in Design & branding (see the table below).
Homepage sections
Choose the Homepage layout: Front page (slider, then the latest stories with the sidebar) or Grid (a simple grid with the sidebar). Every block can be switched off:
| Section | Content comes from |
|---|---|
| Featured slider | Posts marked Featured (post settings → Feature this post), 5 at most. They are removed from the latest stories to avoid duplicates. |
| Topic section (off by default) | The 4 latest posts of the tag whose slug you enter in Homepage tag. |
| Sidebar · About | Your logo, the site description and your social links. |
| Sidebar · Editor’s picks | Numbered list of the posts with the internal tag #picks, 4 at most. |
| Sidebar · Topics | Your 12 most used public tags. |
| Quote of the week | The excerpt of the latest post tagged #quote, signed by its author. |
| Meet our writers | Up to 6 authors who have published, most active first. |
# (type #picks in the Tags field of a post). Readers never see them and they have no public page; the theme uses them to pick content.#picks tag feeds the small sidebar widget.Tag & author pages
Tags open on a cover: the tag image (Tags → image, 2000 px wide recommended) with the name, description and post count; without image, the accent colour with the name as a watermark. Authors use their cover image (Settings → Staff). A row of chips links to the other tags or authors.
Appearance
Light, Dark or Auto scheme (readers can switch), an optional Logo for dark mode, and the Ghost accent colour for links and buttons. Default fonts: Golos Text and Inter.
All settings
| Setting | Tab | Default | What it does |
|---|---|---|---|
| Color scheme | Site-wide | Light | Default color scheme. Readers can still switch with the toggle. |
| Logo for dark mode | Site-wide | — | Optional logo used when the dark scheme is active |
| Footer text | Site-wide | Stories about travel, food, style and the spaces we live in. | Short tagline displayed in the footer |
| Other social links | Site-wide | — | Extra social profile URLs, comma-separated (Pinterest, WhatsApp, GitHub...) |
| Newsletter heading | Site-wide | Join our community | Heading of the newsletter block at the bottom of the page |
| Newsletter text | Site-wide | Get notified about upcoming articles. | Text of the newsletter block at the bottom of the page |
| Homepage layout | Homepage | Front page | Front page: headline block and tag sections. Grid: a simple post grid. |
| Show featured slider | Homepage | On | Large slider of posts marked as Featured, at the top of the homepage |
| Show topic section | Homepage | Off | Optional section with the latest posts of one tag, after the slider |
| Homepage tag | Homepage | travel | Slug of the tag shown as a section after the slider (e.g. travel) |
| Show newsletter | Site-wide | On | Newsletter signup block at the bottom of every page |
| Show quote section | Homepage | On | Quote of the week: excerpt of the latest post tagged #quote |
| Show authors section | Homepage | On | Meet our writers: the authors of the publication |
| Show sidebar | Homepage | On | Sidebar next to the latest stories |
| Sidebar about | Homepage | On | Sidebar: site description, writers and social links |
| Sidebar featured posts | Homepage | On | Sidebar: Editor's picks, a numbered list of posts tagged #picks |
| Sidebar topics | Homepage | On | Sidebar: list of the most used tags |
| Table of contents | Post | On | Show a table of contents on posts with three or more headings |
Posts per page: 12 (set by the theme). Settings are in Settings → Design & branding → Customize, in the Site-wide, Homepage and Post tabs.
Navigation & social links
- 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
Why are my Featured posts not in the latest stories?
They are already in the slider at the top. Switch the slider off and they come back in the list.
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.2.2. Updates are free: download the new package from your Gumroad library and upload its gazette.zip as in Installation; your settings are kept.
- 1.2.2 (1 November 2026): Featured slider: valid markup for screen readers (each slide is the panel of its numbered tab). Text on accent-coloured buttons gets its colour before the page shows, without a flash from white to dark.
- 1.2.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.2.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.1.1 (22 October 2026): Native Ghost share button (
#/share) after the share links; heading order fixed on tag and author pages; author name in the author card is a heading; comment link labelled when a post has no comments yet; text on the accent colour turns dark or light, and accent-coloured text darkens, so any accent set in Ghost stays readable (WCAG AA); newsletter text at full contrast. - 1.1.0: New blog look: centred masthead with the date, slider tabs on a frosted band with cross-fade, borderless post cards with author avatars, sidebar with writers, numbered editor’s picks and topic counts, dark footer.
- 1.0.1: Added this README.
- 1.0.0: First release.