Skip to content
Guides

How to change your Ghost theme without losing anything

Your posts, members and tags never depend on the theme. What does change, and a five-step checklist to switch safely.

A bookshop behind a large arched window in a stone wall
Photo by Annie Spratt / Unsplash

Good news first: in Ghost, the theme is only the look. Your content lives in the database, separate from it. Changing theme never deletes a post, a member or a subscriber. A few things still need your attention.

A couple happily moving boxes into their new home
Photo by Vitaly Gariev / Unsplash

What stays exactly as it was

  • Posts, pages, images and their URLs.
  • Members, subscribers, tiers and newsletters.
  • Tags (public and internal), authors, the Featured mark.
  • Navigation, site title, logo, accent colour, code injection.

What you set again

  • Theme settings. The options in Design & branding → Customize (homepage sections, layouts, fonts) belong to each theme. The new theme starts with its own defaults.
  • Post templates. If a post uses a template the new theme does not have, Ghost shows it with the default template. Nothing is lost; it just looks standard.
  • Internal tags. They stay on your posts, but each theme reads its own: one shows #picks, another #selected. Check the new theme’s documentation and add its tags to a few posts.
  • Your navigation. It stays, but a menu designed for one theme may look different in another: sub-menus, for example, are a theme feature.

Five steps to switch safely

  1. Export your content in Settings → Advanced → Import/Export, and download your current theme from Design & branding. You can go back at any time.
  2. Read the new theme’s documentation: which tags and settings feed its homepage.
  3. Upload and activate the new theme. Do not import its demo content on a site that already has posts: it would add the demo posts to yours.
  4. Go through Customize, section by section, and add the internal tags the theme uses.
  5. Check a few pages: the homepage, a long post, a tag page, an author page, on a phone too.
💡
Your old theme stays in Design & branding until you delete it. If something looks wrong, activate it again in one click.

Every theme of our collection has documentation that lists the tags and settings of its homepage. Compare them →

Keep reading