Skip to main content

Theme settings reference

All theme-specific settings are defined in package.json under config.custom. They appear in Ghost Admin → Settings → Design → Theme and are available in templates as @custom.<key>.

Layout and branding

KeyTypeDefault / optionsDescription
navigation_layoutselect"Logo on the left"Logo on the left, in the middle, or stacked
title_fontselect"Modern sans-serif"Modern sans-serif or Elegant serif (headings)
body_fontselect"Modern sans-serif"Modern sans-serif or Elegant serif (body)
color_schemeselect"Auto"Auto, Light, or Dark
white_logo_for_dark_modeimageLogo for dark mode (optional)
header_logoimageLogo for header, favicon, and social sharing. Leave empty for theme text.

Homepage (group: homepage)

KeyTypeDefaultDescription
hero_headlinetext"Untangle complex technical and operational problems."Homepage hero H1
hero_subtexttext"Sustainable systems rooted in data, collaboration, and measurable impact."Homepage hero subtext
show_featured_postsbooleantrueShow featured posts on blog index
featured_titletext"Featured articles"Heading for featured section

Post (group: post)

KeyTypeDefaultDescription
show_authorbooleantrueShow author on posts
show_related_postsbooleantrueShow related posts block
KeyTypeDefaultDescription
footer_biotext"Independent technical consultant. Systems, automation, applied AI. Souris, PEI."Footer bio text
contact_emailtext"manny@mannyroy.com"Contact email (e.g. for contact page)
contact_form_actiontext"https://formspree.io/f/YOUR_FORM_ID"Form submission URL (e.g. Formspree). Replace with your form ID.

Ghost application page (group: ghost)

KeyTypeDefaultDescription
ghost_hero_titletext"Applying to Ghost"Ghost application page hero title
ghost_hero_subtexttext(one sentence about the application)Ghost application page hero subtext
ghost_cta_headlinetext"Questions or want to connect?"CTA section headline
ghost_cta_buttontext"Get in touch"CTA button label
ghost_posts_headingtext"Build logs & technical writing"Heading above tagged posts on Ghost application page

Ghost limits themes to 20 custom settings total. The above use the available slots; matrix and highlight text on the Ghost application page are hardcoded in the template. To add a new setting, add it to config.custom in package.json and use @custom.<key> in the relevant template.