Submit your theme

Learn how to submit your own theme

Thousands of people start new Ghost publications every single month, and almost all of them end up looking for a great design for their brand new site. The Ghost Marketplace is curated directory to showcase the best themes available to people who are looking to get started.

We run the marketplace as a very simple showcase gallery with direct links to creators. We do not take any cut, commission or credit for the work of theme developers.

Anyone is welcome to submit a theme to the marketplace - however due to a very high number of submissions, we only accept the very best themes to showcase publicly on Ghost.org.

Marketplace

What sort of themes get accepted?

Design is certainly subjective in many ways, but there are a great deal of best practices which are taken into account when evaluating a theme for inclusion in the marketplace, such as flow, hierarchy, balance, and contrast, as well as use of typography, color, and negative space.

We also look for a well designed user experience. As well as being visually beautiful, themes should work smoothly, be easy to navigate, and make use of Ghost's available features.

Beyond a great design and a great experience, we look for themes which are unique, well maintained, offer support to their users, and are easy to set up and use for publishers.

Why do some themes not get accepted?

The most common reason is simply that we don't think the design is the right style or fit for the public marketplace. We can't give detailed design feedback for every single submission, but if your application is unsuccessful on the grounds of style then please understand that it's not personal. We do our best to curate a very high standard of themes, and we simply can't accept all of them.

The next most common reason is lack of originality and looking too similar to other existing themes in the marketplace. There are hundreds (maybe thousands?) of forks of our default theme (Casper) out there with a few minor visual tweaks. They're often very nice, but they aren't very useful for new users wading through the marketplace for the first time.

Theme requirements

All themes in the marketplace must meet our development standards in order to be approved.

General requirements

  • Themes should pass compatibility validation using GScan
  • Themes should have a responsive layout and mobile friendly styles, with compatibility for the latest 2 versions of Chrome, Firefox, Safari and IE/Edge
  • Themes should make proper use of the asset helper to load all assets
  • Themes should include a "Published with Ghost" link to Ghost.org

Code standards

  • Follow the docs
  • Use code comments: Document your work (Check out Casper for a good example)
  • Create a sane file structure.
    • Do use partials to manage components sensibly
    • Don't use partials for every little snippet of code under the sun
  • Include a detailed ReadMe.md with information about the theme, its features, and where to go for help
  • Include a properly formatted package.json

Search Engine Optimisation

  • Themes should have clearly structured data and HTML tags which are search engine friendly
  • All parts of the theme should have a clearly linked navigation structure
  • No SEO "tricks" - clean, well structured markup. That's it.

Accessibility

  • Images must have alt attributes
  • Theme should be built with valid HTML
  • Theme should be accessible with keyboard navigation
  • Theme should be optimised for colour contrast where possible

Recommendations

  • Include extensive base styling for all possible types of content which someone might enter into the Ghost editor
  • Make good use of tag and author archives
  • Create custom styling and layouts for posts which are marked as "featured"
  • Ensure good fallbacks when content is empty or unavailable (no featured image, no author bio, no post tags, etc)

How to submit a theme

To submit a theme, you'll need to send an email to [email protected] with a link to a working demo of the theme you'd like to submit, and an attached zip of the theme files.