How to install and activate theme on Ghost

beginner 8 min read Updated 2026-03-18

Quick Answer

Installing a Ghost theme involves uploading the theme zip file through the admin panel's Design settings and then activating it. The process takes just a few clicks and your new theme will be live immediately after activation.

Try Ghost Full Ghost Review

Prerequisites

Ghost blog with admin access
Theme file in .zip format
Basic understanding of Ghost admin panel
Web browser with stable internet connection

Step-by-Step Instructions

Download your Ghost theme

Ensure you have your Ghost theme file downloaded and saved as a .zip file. Do not extract or unzip the file - Ghost requires the theme to be uploaded in its compressed format. Verify the file is complete and not corrupted by checking its file size matches the download source.

Always download themes from reputable sources like the official Ghost Marketplace or trusted theme developers.

Access Ghost admin panel

Open your web browser and navigate to your Ghost blog's admin panel by adding /ghost to your blog's URL (e.g., yourblog.com/ghost). Log in using your admin credentials to access the dashboard.

Navigate to Design settings

In the left sidebar of your Ghost admin panel, click on Settings. From the settings menu, select Design. This will open the theme management area where you can see your currently active theme and upload new ones.

Take note of your current active theme name in case you need to revert back to it later.

Upload the new theme

Scroll down to the bottom of the Design page and click the Upload a theme button. A file browser window will open. Select your theme's .zip file from your computer and click Open. Ghost will automatically upload and install the theme.

The upload process may take 30-60 seconds depending on your internet connection and theme file size.

Preview the theme (optional)

After upload, your new theme will appear in the installed themes list. Click the three dots menu next to your newly uploaded theme and select Preview. This opens your blog in a new tab with the new theme applied, allowing you to see how it looks without making it live.

Use preview mode to test the theme's appearance and functionality before activating it for your visitors.

Activate the theme

If you're satisfied with the preview (or want to activate directly), click the three dots menu next to your theme and select Activate. Alternatively, click the Activate button that appears when hovering over the theme. Confirm the activation in the popup dialog.

Your previous theme will be automatically deactivated when you activate the new one, but it remains installed.

Verify theme activation

Visit your blog's homepage in a new browser tab to confirm the new theme is active and displaying correctly. Check key pages like individual posts, archives, and any custom pages to ensure everything renders properly with your new theme.

Clear your browser cache or use an incognito window if you don't see the changes immediately.

Common Issues & Troubleshooting

Upload fails with 'Invalid theme' error

Ensure your theme file is a valid .zip file and compatible with your Ghost version. Check that the zip contains a package.json file and proper theme structure. Try re-downloading the theme from the source.

Theme appears broken or unstyled after activation

Clear your browser cache and hard refresh the page with Ctrl+F5 (Windows) or Cmd+Shift+R (Mac). If the issue persists, the theme may have compatibility issues with your Ghost version or missing assets.

Cannot access upload theme button

Verify you have administrator or owner permissions on the Ghost blog. Only users with admin rights can install themes. Contact your blog owner if you're not the administrator.

Uploaded theme doesn't appear in themes list

Refresh the Design settings page and check if the upload completed successfully. If the theme still doesn't appear, try uploading again or check your Ghost installation's file upload limits and available storage space.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Ghost website before purchasing.

Visit Ghost View Ghost Pricing