Troubleshooting

My changes don't show on my Ghost site

Fantasma saves your changes to the project as you work, but your Ghost site gets them only when you publish the theme from Fantasma, or download it and upload it in Ghost. Publishing makes the theme active at once.

The Fantasma canvas fills your pages with demo posts unless you choose your own posts, so a page can look different there for that reason alone. Preview with your Ghost content and members shows how to switch.

Check the basics first

  • Reload your site with the browser's cache skipped: ⌘ Shift R in Chrome, Firefox and Edge, or ⌥ ⌘ R in Safari. On Windows, Ctrl replaces ⌘. Or open the site in a private window.
  • Posts, pages, tags, authors, the site menu and the logo are edited in Ghost Admin, not in Fantasma. A change to them shows on the site without a new theme.
  • Some sections show only to members, or only on some screen sizes. Open the site in a private window, where you are not signed in as a member, and try a phone as well as a computer.
  • If a CDN or a caching service sits in front of your site, it can show the old pages for a while after a publish. Wait a few minutes. Your host can tell you whether one is in front of your site, and clear it.

You have not published since the change

In the Fantasma editor, click Publish at the top of the right sidebar. Its menu shows the version this publish gets, such as v2.0.0-3. When the version stands out in color, your site does not have your latest changes; point at it to read "The theme has new changes. Publish again to update Ghost." Click Publish at the bottom of the menu. See Publish your theme to Ghost. If "Publish failed" appears instead, Publishing to Ghost failed explains the reason.

If your project is not connected to your Ghost site, the button reads Download instead. Download the theme again and upload the new file in Ghost, as Download your theme and upload it in Ghost shows.

A different theme is active in Ghost

Someone may have switched themes in Ghost Admin after your publish, or a theme was uploaded by hand under another name. In Ghost Admin, open Settings, then Design & branding, and click Change theme. Ghost's list of themes shows which one is active. Fantasma's theme is named fantasma- followed by your theme name, such as fantasma-ridgeway-dispatch. If another theme is active, activate yours there.

The theme name is in Fantasma under Project settings › General › Theme name; open Project settings from the sliders icon in the icon rail. After a change to it, Ghost gets a theme with the new name, and the theme with the old name stays in Ghost's list until you delete it there. If Ghost lists more than one theme that starts with your theme name, a ZIP was uploaded under another file name. Activate the one you uploaded last, then delete the other copies from the same list in Ghost. Ghost does not delete the active theme.

The project publishes to another site

On the Ghost page of Project settings, check the site's name and address. If you connected a test site, connect the live one instead, as Connect your Ghost site shows.

Two projects share a theme name

If another of your projects has the same theme name, the line under Theme name in Project settings › General says "Another project uses this name. Publishing one replaces the other." Publishing that other project replaced your theme in Ghost. Give one of the projects another theme name, then publish the one you want live.

A new address shows an error page

A new collection, a part of your site with its own address such as /projects/, or a changed address needs a new routes.yaml in Ghost, separate from the theme. Fantasma reminds you in the Download or Publish menu. Until Ghost has it, the new address shows an error page, and posts stay at their old addresses. Upload routes.yaml shows how.

Something in Ghost overrides the theme

Code in Ghost Admin's Code injection, in Ghost's settings, loads on every page whatever theme is active. CSS there can hide or change what you designed in Fantasma. If you or a developer added code there, copy it somewhere safe, remove it for a test, and reload your site. Paste it back afterwards if it was not the cause.

Contact support

If the site still shows the old design, contact us and send:

  • the address of the page that looks wrong
  • a screenshot of the page next to a screenshot of the same page on the Fantasma canvas
  • the version shown in the menu that opens from Publish or Download, such as v2.0.0-3
  • when you last published or uploaded the theme

Was this article helpful?