Skip to content

Troubleshooting

Symptom: Changing the accent color in Ghost Admin has no visible effect, or the color shown in the theme does not match what you entered.

Causes and fixes:

  1. You may be setting the color in the wrong place. Ghost has a Brand color field under Settings → General that is separate from the Quietus accent_color theme setting. The theme setting in Settings → Design → Customize takes precedence and is the correct place to set the Quietus accent.
  2. Your browser may be serving a cached version of the site. Hard-refresh the page (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows) after saving the setting.
  3. If you entered a hex value, confirm it is a valid six-digit hex with a leading # (e.g. #a5552f).

Feature image appears at the top of every essay

Section titled “Feature image appears at the top of every essay”

Symptom: Feature images are showing in the essay view when you would prefer them not to.

Causes and fixes:

  1. show_feature_image is enabled (the default). Go to Settings → Design → Customize and disable it to suppress feature images across all posts.
  2. If you want to suppress the feature image on a single post rather than globally, open the post in the Ghost editor, go to the post settings panel, and remove the feature image from that post.

Symptom: The site appears in Light mode even though the reader’s system is set to dark.

Causes and fixes:

  1. color_scheme is set to Light (the default), which overrides the system preference. Go to Settings → Design → Customize and set color_scheme to Auto to follow the reader’s operating system, or to Dark to force the dark palette for all readers.
  2. If color_scheme is already set to Auto and the site still appears in Light mode, the issue is likely with the reader’s browser or system configuration, not the theme.

Symptom: Ghost Admin shows an error when you try to upload the theme .zip.

Causes and fixes:

The most common cause is uploading a folder or a double-nested archive. Ghost expects the .zip to contain the theme files at the top level, not inside a subfolder. Re-download the theme from your Gumroad receipt and upload that file directly without extracting or re-compressing it.