Beginner
How to install and activate theme on Ghost
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.
Prerequisites
- Ghost blog with admin access
- Theme file in .zip format
- Basic understanding of Ghost admin panel
- Web browser with stable internet connection
1
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.
Tip
Always download themes from reputable sources like the official Ghost Marketplace or trusted theme developers.
2
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.3
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.
Tip
Take note of your current active theme name in case you need to revert back to it later.
4
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.
Tip
The upload process may take 30-60 seconds depending on your internet connection and theme file size.
5
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.
Tip
Use preview mode to test the theme's appearance and functionality before activating it for your visitors.
6
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.
Tip
Your previous theme will be automatically deactivated when you activate the new one, but it remains installed.
7
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.
Tip
Clear your browser cache or use an incognito window if you don't see the changes immediately.
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.
Ready to get started with Ghost?
Put this tutorial into practice. Visit Ghost and follow the steps above.
Visit Ghost →