Ghost 0.5.2

Ghost 0.5.2 contains several new features as well as a refresh of the admin design, important bug fixes, updates to the theme API, JSON API and importantly breaking changes to the way Ghost is started if you use it as an npm module.


[New] Admin design refresh
[New] About Ghost page
[New] Post settings menu
[New] Meta data screen in post settings menu
[New] Post cover image option in post settings menu
[New] Privacy config flags
[New] Direct mail sends mail without config
[Improved] Error handling when starting Ghost
[Fixed] Request entity too large error
[Fixed] 'Post NOT saved' dialog keeps appearing on Safari
[Fixed] Author dropdown only shows 15 authors
[Fixed] Switching between blog and admin can cause blog to lose styling
[Fixed] UpdateCheck can prevent login
[Fixed] Login conflicts with multiple Ghost installs

Breaking Changes

[Changed] Ghost no longer starts automatically when used as an npm module
[Changed] Keyboard shortcut for headings is now Ctrl/⌘ + H

In Detail

Configuration changes

Ghost now supports direct mail. This means you no longer have to specify mail config for Ghost to be able to send emails. Direct mail is not as reliable as a 3rd party mail service, and emails may end up in spam, but you at least have a chance at getting the forgotten password email ;)

Additionally, we've improved the from address configuration. mail.fromaddress has been deprecated in favour of mail.from and now accepts either just an email address or a from address in the form: Custom name <>. The default if left unset is Blog title <ghost@blog-url>, for more information see the mail guide on

Along with our new file, we've also added a new set of privacy config options to allow you to disable any of the features listed. In line with this, the updateCheck option has been deprecated in favour of privacy.useUpdateCheck. You can see all the new config options in the configuration guide on

For those of you keeping an eye on our JSON Data API, there's a shiny new configuration API endpoint which has been added to provide access to some of the configuration options. This was used to build the new about Ghost page which appears in settings.

Theme API changes

Ghost 0.5.2 includes the following additions and changes to the Theme API:

[New] {{is}} helper
[New] Custom tag templates
[New] {{image}} for posts
[Changed] {{body_classes}} outputs different classes
[Changed] {{ghost_head}} outputs pre & next links
[Changed] Meta title & description helpers

For full details of what has changed and details on how to use the new features, please see the theme change log.

Using Ghost as an npm module

If you've been using Ghost as an npm module, you'll need to update your custom code which requires ghost after upgrading to 0.5.2. You'll find instructions on how to this on the wiki page. Please also note that as we have switched our promise library from when to bluebird that you'll need to use catch for handling rejections rather than otherwise.

You can see the full change log for the full details of every change included in this release.

How to Upgrade

All Ghost(Pro) users are being automatically updated and will be running Ghost 0.5.2 shortly. You're welcome :)

For people running Ghost on their own servers, you can download Ghost 0.5.2 and then check out the upgrade documentation over on our support site.



This release was lovingly crafted by John O'Nolan, Paul Adam Davis, Fabian Becker, Hannah Wolfe, Jason Williams, Felix Rieseberg, Matt Enlow, Harry Wolff, Gabor Javorszky, Robert Jackson, Jilles Soeters, Nicola Mustone, Maurice Williams, David Blurton, Sebastian Gierlinger, Thai Phan, cobbspur, Andrej Mlinarević, hiroshi kobayashi, Ashish Dixit, Chris Pearce, Jake Wright, Jamie Knight, Jay Beavers, Josh Vanderwillik, Julien Gilli, Kirill Yakovenko, Mattias Cibien, Mo Valipour, Pedro Teixeira, Robert Rhoades and Sarah.

Get notified when we ship new features.