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

Update Offset

Back up your theme, install a new release, and verify the result.

Before an update

Read the release information supplied with the new ZIP and check its Ghost compatibility. This guide covers Offset 1.0.0; a later release may change available controls or requirements.

Download your active theme from Settings → Site → Theme → Change theme → Installed. Keep a copy of any custom templates, CSS changes, translations, Code Injection, and custom routing. Record your current theme settings, especially newsletter copy, Report URL, topic order, and article switches.

A theme backup is not a full publication backup. Use Ghost’s export and your hosting backup process for content, images, and server configuration as appropriate.

Install the update

  1. Obtain the new installable Offset release ZIP.
  2. Upload it from Settings → Site → Theme → Change theme → Upload theme.
  3. Review validation messages and any same-name replacement prompt.
  4. Activate the updated theme if Ghost requests activation.
  5. Reopen Design & branding → Customize and verify your settings.
  6. Reload the public website and follow the checks below.

Uploading a theme does not intentionally replace your articles, members, tags, or navigation. Edits made directly inside old theme files do need to be reapplied deliberately to the new version. Do not overwrite the update with old files without comparing them.

Verify the publication

Check the homepage lead, dispatch, topics, Report banner, and newsletter area. Open a long article with headings, images, related stories, and comments if enabled. Open a regular page and your Membership template page if you use one.

Test a tag archive with enough posts for another page and confirm the selected pagination mode. Test an author archive, navigation, search, Portal, and any protected article preview you offer. Repeat the essential checks on a phone and with a keyboard.

If you self-host Ghost and edit theme files directly, changes to package.json require restarting Ghost. Production template changes can also require a restart. Use your host’s normal deployment process.

Roll back if needed

Return to Theme → Change theme → Installed and activate your saved previous theme, or upload your backup ZIP if it is no longer available. Recheck the settings after restoring it.

A theme rollback does not undo a Ghost upgrade, database change, payment, or content edit. Treat those as separate operations with their own backup and recovery procedures.

Report a regression

Contact contact@creative-koda.com with the old and new Offset versions, Ghost version, affected public URL, steps to reproduce, and screenshots. Mention custom CSS, templates, translations, or routes that could affect the result.

Need a visual reference?

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