Offset — an editorial magazine theme for GhostExplore the live demo
Offset documentation · All guides

Troubleshooting and support

Diagnose common setup problems and check your publication before launch.

The theme will not upload

Confirm that you selected the installable Offset ZIP rather than the repository’s source archive or a folder. Check your Ghost version against the release’s compatibility requirements and confirm your hosting plan permits custom themes.

Read Ghost’s validation message before retrying. Keep that message for support. Do not remove an existing working theme while diagnosing a failed upload.

My homepage looks empty

Publish posts, not just drafts or static pages. Offset does not include demo content. Three published posts populate the opening selection; up to five populate Latest. Feature posts for the dispatch and assign public tags for topic sections.

If you use custom routes or collections, check that the root URL uses the intended homepage template and the collection includes the content you expect.

A topic is missing or appears in the wrong order

Check that its tag is public and has a published post. An internal #tag or an unused tag will not create a section. For repeated stories, inspect the public tags assigned to those posts.

Check Topic order and save it. JavaScript must run for the selected browser-side ordering; without it, Ghost’s article-count order remains. Clear stale cached pages if your hosting/CDN still serves old content.

The Report banner does not appear

Fill Report url in Homepage settings and save. A title and description alone are insufficient. Open the exact destination to check it exists. Include your Ghost installation subdirectory for root-relative paths on a subdirectory installation.

The banner normally moves below the first topic with JavaScript. Without it, or without topics, check after the topic area instead.

The table of contents is absent

Enable Show table of contents and include at least two H2/H3 headings in the article content available to the current reader. Bold paragraphs and H1 headings do not count. JavaScript must be enabled. Paywall headings are excluded from the generated outline.

For related posts, enable the setting and assign a primary public tag shared with another published article. The current article is excluded from suggestions.

For comments, enable both Offset’s Show comments setting and Ghost’s commenting policy. Check as a reader who has access to the article. A theme switch does not override Ghost’s member permissions.

The signup form is absent or email does not arrive

Check membership access and public-signup settings. The inline form is hidden for signed-in members and invite-only publications. Test in a signed-out browser session.

If submission fails or email never arrives, inspect Ghost’s email configuration, default newsletter, and delivery service. Check spam folders. The website form cannot configure outbound mail. Do not share API keys or member records with a support request.

Confirm that the page uses the Membership template and that Ghost has public paid tiers with the intended prices. Check Stripe connection and Portal options. Signed-in members see account management rather than the signed-out plan grid.

A demo without connected Stripe is not evidence that your production checkout is configured. Payment availability belongs to Ghost and Stripe.

Load more does not appear

A single-page tag archive has no pagination control. Check that enough published posts belong to the tag and that Tag pagination is set to Load more. Author archives always use page links.

Without JavaScript, regular page links are expected. If loading another page fails, use the offered next-page fallback and check the destination response, custom routes, network, and CDN caching.

A logo, font, or embed looks wrong

Use a logo that is legible against dark surfaces. Verify Ghost’s Brand settings and whether custom CSS overrides them. Fonts depend on the selected native font and any external font requests.

For broken layouts, temporarily remove the relevant custom CSS or HTML embed and compare again. Check whether a third-party embed has a fixed width. Inspect image crops across the lead and smaller cards rather than relying only on the editor preview.

Before you launch

  • Check homepage, article, regular page, tag archive, author archive, and membership page if used.
  • Open every primary and secondary navigation destination.
  • Verify title, description, icon, logo, metadata, and social previews in Ghost.
  • Check desktop, tablet, and phone layouts, including long titles and code/embeds.
  • Use Tab to reach controls; open the menu and close it with Escape.
  • Test signed-out and authorized member views for protected content.
  • Test signup and login email delivery with an address you control.
  • Confirm your real tier descriptions and prices in Ghost before enabling paid subscriptions.
  • Publish the supporting legal/contact pages your publication needs.

Contact support

Email contact@creative-koda.com. Include the Offset version, Ghost version, affected URL, browser/device, expected result, actual result, steps to reproduce, and a screenshot if useful. Mention custom routes, CSS, templates, or translation files.

Never include a password, Admin API key, payment credential, or private member export. A public URL and a minimal description of the issue are usually enough to start.

Need a visual reference?

Use the live demo to compare your settings with a working Offset site.