How to Install a Ghost CMS Theme
Installing a theme in Ghost CMS is one of the quickest things you can do when setting up your site. Unlike other platforms, there is no plugin installer, no version conflicts to sort out, nothing to compile. You upload a zip file and the theme goes live.
If this is your first time doing it, this guide covers the full process in order. Including the small details most tutorials skip.
Before You Upload Anything
Your theme file needs to be in .zip format. Keep it zipped. Ghost unpacks it automatically on upload, and dragging in a loose folder will not work.
If you are still choosing a theme, the Themes Supply marketplace has a solid mix of free and premium options built specifically for Ghost. Every theme there is built for Ghost natively, which matters more than it sounds. Generic themes ported from WordPress or other platforms often throw compatibility errors on upload, even when they look fine in a preview.
One thing worth knowing before you get started: if you want to use a custom theme on Ghost Pro ↗, you need at least the Creator plan. The Starter plan does not support custom theme uploads. If you want more hosting flexibility or are not yet committed to Ghost Pro, check out the best Ghost CMS hosting options before deciding. And if you are new to the platform entirely, the guide on what Ghost CMS is is a good place to start.
Installing a Ghost CMS Theme Step by Step
Step 1: Open Design and Branding
Log in to Ghost Admin at yourdomain.com/ghost. Click the gear icon at the bottom-left to open Settings, then select Design & Branding. The Change theme button sits in the bottom-right corner of that panel.
Step 2: Upload the Zip File
Click Upload theme in the top-right corner. Select your .zip file and Ghost will upload it and run an automatic compatibility check in the background.
If the upload fails, check which version of Ghost the theme was built for before anything else. Themes built for Ghost 4 or Ghost 5 will often fail validation without any changes on your end, and the error message does not always tell you that clearly. The fix is usually finding a theme that explicitly supports Ghost 6.
One more thing: previous uploads stay saved under the Installed tab. Handy if you want to test something and switch back without re-uploading.
Step 3: Activate
Click Activate. The theme goes live immediately, no cache clearing needed.
Customizing After Activation
Most themes give you a reasonable amount to work with right out of the box. Go back to Design & Branding and you can adjust colors, fonts, and layout options directly from that panel, with no code required.
For anything the panel does not cover, Settings > Code Injection is where you add custom CSS. Changes made there survive theme updates. If you edit files directly inside the theme folder, those changes get wiped the next time you update. Code Injection is the right habit to build from day one.
Before moving on, open an incognito window and preview the site. Ghost Admin adds a toolbar to the top of the page that shifts your layout slightly. Incognito removes it completely and shows you exactly what a first-time visitor sees. Every time we skip that step we end up catching something later.
A Few Things That Catch People Out
Most installs go smoothly. But a couple of situations come up often enough that they are worth knowing about before you run into them.
The theme activates but the layout looks broken
This usually means the theme needs route settings that were not configured during setup. Check the theme documentation for any required routes.yaml changes. Most modern Ghost themes from the Themes Supply marketplace include clear setup instructions for exactly this.
You want to go back to the previous theme
Ghost keeps all your uploaded themes saved. Go back to Design & Branding, click Change theme, and switch to any theme in the Installed tab without re-uploading anything.
The upload fails with no clear error
File size is sometimes the cause. Ghost has a 30MB upload limit for theme files. If your zip is larger than that, something in the package is likely unnecessary. Most well-built themes come in well under 5MB.
Note: Ghost pricing tiers and plan names change periodically. The plan details mentioned above reflect Ghost Pro’s structure as of early 2026. Check the current plans at ghost.org/pricing before making a decision.
The install itself is never the hard part. Finding a theme that actually fits how you publish, and customizing it without breaking things, is where most people spend their time. Get the basics right first, then go from there. And if you are still looking for the right option, browse the new Ghost themes available on Themes Supply.