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
- Obtain the new installable Offset release ZIP.
- Upload it from Settings → Site → Theme → Change theme → Upload theme.
- Review validation messages and any same-name replacement prompt.
- Activate the updated theme if Ghost requests activation.
- Reopen Design & branding → Customize and verify your settings.
- 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.
Use the live demo to compare your settings with a working Offset site.