Download and upload routes.yaml

Ghost uses routes.yaml for custom routes, collections, and redirects. Fantasma generates this file for your project; you still upload it in Ghost — a new theme ZIP alone does not replace routing.

Why Labs? Routing affects live URLs. Ghost asks you to confirm changes under Settings → Labs → Routes, including when you publish from Fantasma. Follow any routes warning in the builder until Labs has the latest file.

Plans: Downloading routes.yaml follows whatever tier allows your project to Download ZIP or Publish. Uploading in Ghost is normal Ghost setup, not a Fantasma billable step.

Steps

  1. In Fantasma, download routes.yaml when routes changed or the UI warns you.
  2. Keep the filename exactly routes.yaml.
  3. In Ghost: Settings → Labs → Routes.
  4. Upload (or paste, per your Ghost version) and apply the change so rules reload.

When to repeat

Whenever Fantasma changes collection URLs, redirects, or other routed templates, get a fresh routes.yaml and upload it again.

If URLs look wrong

  • 404s or empty collection pages — Stale YAML or posts missing internal tags — see Collections & tags.
  • Warning after publish — Expected until Labs has the matching file.

Related links