Offset documentation · All guides
Customize Offset
Make small CSS changes, translate interface labels, and maintain advanced edits.
Start with native settings
Use Ghost’s Brand panel for logo, accent color, and fonts. Use the theme settings for newsletter copy, Report copy, article modules, topic order, and tag pagination. These controls are easier to maintain than editing templates.
Add a small CSS override
For a focused styling change, open Settings → Advanced → Code injection and place CSS inside a <style> element in Site Header. For example, this optional rule increases article line spacing:
<style>
.article-content {
line-height: 1.8;
}
</style>
Save, open a public article, and check paragraphs, headings, lists, and cards on desktop and mobile. This is an illustrative override, not a required installation step. Remove it to restore the default. Keep a separate copy of your snippets and review them after theme updates.
Avoid changing membership visibility or access with CSS. Hiding a control does not enforce content permissions; use Ghost’s access settings.
Translate interface labels
The theme ships an English translation file at locales/en.json. For another language, copy it using Ghost’s locale filename convention, translate the values while preserving keys and interpolation placeholders, and set the publication language in Ghost.
Theme translation strings include interface labels such as Editor’s dispatch, Latest, and the Report banner’s button. Custom newsletter and Report text belongs in the theme settings. Your articles, tag names, page content, and navigation labels must be translated separately.
There is no shipped complete French translation. Add and verify your own locale before presenting a translated site as complete. See Ghost theme translation documentation for locale conventions.
Self-host fonts
Offset’s default font stylesheet is linked from default.hbs. To eliminate that Google Fonts request, add appropriately licensed font files to the theme, replace the external stylesheet link with local @font-face declarations, and update the font variables in assets/css/screen.css.
Check how your changes interact with Ghost’s Heading font and Body font settings. Keep system fallbacks and verify the Network panel no longer requests the external font stylesheet. This requires a custom theme package rather than a native Offset switch.
Edit templates carefully
The theme uses plain Handlebars, CSS, and JavaScript. A frontend build is not required for routine installation. Advanced layout changes require editing and repackaging the source.
Preserve Ghost’s head/footer integration, content helper, member controls, editor-card assets, and accessibility behavior. Removing them can break search, Portal, metadata, protected-content rendering, or keyboard navigation.
Keep customizations in version control or a recorded patch. Uploading a later Offset release replaces edited theme files; it does not merge your changes automatically.
Validate a development package
For developers working from the repository, the current tooling requires Node 22.22.2+ within 22.x or Node 24.15+ within 24.x, plus Python 3 for packaging. These are development requirements, not browser requirements for readers.
npm ci
npm test
npm run release
The release command validates source, creates ../dist/offset-ghost-<version>.zip, and checks that archive. It includes template checks, rendered HTML validation, JavaScript checks, and GScan. Use the validated installation ZIP for Ghost.
Automated checks do not prove a working email service, a completed payment, or every protected-content journey on your server. Test those separately in your own publication environment.
Use the live demo to compare your settings with a working Offset site.