Offset documentation · All guides
Install Offset
Upload the installable ZIP, activate the theme, and check your existing content.
Prepare a backup
Before replacing an existing theme, download a copy from Settings → Site → Theme → Change theme → Installed. Keep any custom theme files, Code Injection snippets, and custom routing configuration separately. Export your publication content using Ghost’s Import/Export settings when making broader site changes.
Use the installable theme ZIP supplied with Offset. A GitHub source archive contains development files and is not the same as the validated release ZIP.
Upload and activate
- Sign in to your own Ghost Admin.
- Open Settings → Site → Theme and select Change theme.
- Choose Upload theme and select the Offset installation ZIP, such as
offset-ghost-1.0.0.zip. - Review Ghost’s validation result. If installation fails, use the installation checks.
- Select Activate to make Offset your active theme.
- Open your publication in a new browser tab and confirm the theme has changed.
Ghost groups Design & branding, Theme, and Navigation under Site settings. Labels can vary between Ghost releases. See Ghost’s official theme installation guide for the upload interface.
Keep standard Ghost routes
Offset works with Ghost’s default routing. You do not need to upload a routes.yaml file to install it.
The root homepage uses Offset’s magazine layout. Subsequent standard index pages use its article index. Ghost provides tag and author archive URLs. Publishing a regular page does not replace the magazine homepage.
If you already have custom routes or collections, preserve them and verify that they select the templates you intend to use. Do not replace an existing routing file solely to match a demo.
Add enough content to evaluate the layout
Publish at least three posts to populate the lead and supporting stories. Five published posts fill the Latest selection. Add public tags to create topic sections, and feature at least one post for the dispatch.
The theme does not import demo articles, artwork, legal pages, or navigation links. Create those in Ghost. A sparsely populated publication will naturally have fewer stories and sections than the demo.
Check after activation
Open the homepage, one article, a regular page, a public tag archive, and an author archive. Check the logo, primary menu, footer links, feature images, and any membership controls you use. Repeat on a narrow screen.
Continue with branding and navigation and homepage configuration.
Use the live demo to compare your settings with a working Offset site.