Skip to content

Theme version: 1.6.0 — 07 June 2022 Documentation

Back Up Your Current Theme First

Please backup your current theme before updating to a new version.

  • Log in to your Ghost admin
  • Go to Settings > Design > Change theme > Advanced
  • Download your active theme

Theme Updating

If you have not made any changes to your current theme files, download the latest version of the theme and upload it to your website. You do not need to worry about updating the files in the following steps.

To update the theme, first, download the new version from the theme update email. If you have lost the email or the download link, click here for more details.

To update your current theme, copy and replace the Changed Files below from the new theme version to your theme.

In case of any listed Deleted Files, safely remove the files from your theme.

If there are any New Files listed, copy the files to your theme with the same file path.

Copying a file from the new version to your theme will overwrite your file.

Only redo your customizations if that file receives an update.

If you made CSS customizations in Code Injection, there is no need to worry about these unless I mention any CSS changes.

Once you have finished, zip your theme files and upload the final zip file to your Ghost website.


Watch the following short video for a quick tutorial.

I recommend updating your theme to the latest version to avoid future compatibility issues with Ghost and API depreciation. This will also make it easier to update to future theme versions.

If you missed updating a version, such as your current theme being 1.0.0 and the latest version being 1.0.2, you do not need the intermediate 1.0.1 version to update. Instead, use the newest version (1.0.2) as a base for the 1.0.1 changelog. This is because the most recent version has the latest updated files. So, go through the 1.0.1 changelog and apply the file changes from 1.0.2.

Troubleshooting

If you encounter any issues while updating the theme, make sure to double-check the following:

  • Deactivate and then activate the theme again.
  • Upload the new/fresh theme version to see if the problem is from your theme or the latest version
  • Restart Ghost
  • Make sure you upload the routes.yaml file if received an update in the new theme version
  • Ensure that you have updated all the files mentioned in the changelog below.

VERSION - 1.6.0: Release on 7 June 2022

New

  1. Ghost 5.0 support
  2. Aspire is now using the Ghost Portal and the new Tiers for membership. Clicking the header Login and Subscribe links will show up the Portal instead of going to the Login or Subscribe pages.

Deleted files

members/account.hbs
members/signin.hbs
members/signup.hbs
partials/signup-plans.hbs

Changed Files

routes.yaml
gulpfile.js
package.json
partials/header.hbs
partials/post-upgrade-cta.hbs

/locales/

(Copy all the `/locales/` folder and override your current theme one.)

------------  Version: 1.5.9 — 22 March 2021  ------------

❗ Please update to Ghost 4 first and then apply this version.

[+] New: Ghost 4.0 Support
    - Fixing all compatibility issues
    - Support for the new Public Review content card
[+] Update: Deploy Ghost Theme Github action config file
[+] Fix: Author image style in article page
[+] Improve: Log in and membership text copywriting
[+] Update: ISO code for the Dutch language in search
[+] Update: Rename the Dutch language translation file name to nl.json instead of du.json
[+] Update: The theme is now using Portal notifications instead of the
built-in ones.
In Ghost 4.0, membership becomes an essential part of Ghost and no longer
a beta feature. Accordingly, the login/subscribe, and all membership browser
notifications come from Portal whether Portal is enabled or not.
So, when a person logins to the website, the theme will show a message,
and Portal will show one. Using Portal notifications ensures all notification
messages will be up to date with Ghost membership updates, eliminate the
conflict while login in, subscribe, or update a person’s information.

Ghost CMS Notifications

New Files:
  locales/nl.json

Deleted Files:
  locales/du.json
  partials/notifications.hbs
  assets/sass/components/_notifications.scss

Changed Files:
  default.hbs
  post.hbs

  gulpfile.js
  .jshintignore
  package.json
  package-lock.json

  .github/workflows/deploy-theme.yml

  assets/css/app.min.css

  assets/js/app.js
  assets/js/app.min.js
  assets/js/ghosthunter.js

  assets/sass/components/__all.scss
  assets/sass/components/_author.scss
  assets/sass/components/_content.scss
  assets/sass/components/_archive.scss
  assets/sass/trumps/_type.scss

  locales/da.json
  locales/de.json
  locales/en.json
  locales/es.json
  locales/fi.json
  locales/fr.json
  locales/it.json
  locales/pt.json
  locales/tr.json

  members/account.hbs
  members/signin.hbs
  members/signup.hbs

  partials/compiled/inline-css.hbs

  partials/footer.hbs
  partials/header.hbs
  partials/loop.hbs
  partials/signup-plans.hbs
  partials/post-upgrade-cta.hbs

  partials/sidebar/widget-recent-posts.hbs
  partials/sidebar/widget-subscribe.hbs
  ------------ VERSION - 1.5.8: Release on 24 September 2020 ------------
  [+] Improve: Content typography and embedded iframe improvements
  [+] Improve: Change the `Sign Up` label to `Subscribe`
  [+] Fix: Gulp zip script to include hidden files that are used in and help in development mode. Thanks, Daniel!

  [====] Changed Files:
    assets/css/app.min.css
    assets/js/app.min.js
    assets/sass/components/__all.scss
    assets/sass/components/_content.scss
    assets/sass/components/_post.scss
    assets/sass/trumps/_alerts.scss
    gulpfile.js
    locales/da.json
    locales/de.json
    locales/du.json
    locales/en.json
    locales/es.json
    locales/fi.json
    locales/fr.json
    locales/it.json
    locales/pt.json
    locales/tr.json
    members/signup.hbs
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
    partials/header.hbs
  [====]

  [====] New Files:
    ----
    NOTE: These are files are used in and help in development mode. Not adding them will not affect how the theme works in your blog. They will be invisible by default. If you are using Mac, press (Command + Shift + .) to show them. If you opened the theme in your code editor, you should see them fine.
    ----

    .editorconfig
    .gitignore
    .jshintignore
    .jshintrc
  [====]

  [====] Deleted Files:
    assets/sass/components/_embed.scss
  [====]
  ------------ VERSION - 1.5.7: Release on 20 July 2020 ------------
  [+] Improve: Accessibility
  [+] Improve: General design improve
  [+] New: Add Turkish translation. Thanks Tolga!
  [+] New: Added integration with Deploy Ghost Theme Github action.
  [+] New: Added gulp zip command to easily zip the theme.
  [+] Fix: Show non-public posts in sidebar widget
  [+] Fix: Show sidebar recent posts widget if there already posts exist

  [====] Changed Files:
    assets/css/app.min.css
    assets/sass/components/_content.scss
    assets/sass/components/_logo.scss
    assets/sass/components/_notifications.scss
    assets/sass/components/_search.scss
    assets/sass/components/_tag-card.scss
    assets/sass/elements/_fonts.scss
    assets/sass/elements/_image.scss
    assets/sass/elements/_page.scss
    assets/sass/objects/_grid.scss
    assets/sass/settings/_type.scss
    assets/sass/trumps/_type.scss
    gulpfile.js
    locales/da.json
    locales/de.json
    locales/du.json
    locales/en.json
    locales/es.json
    locales/fi.json
    locales/fr.json
    locales/it.json
    locales/pt.json
    members/signin.hbs
    members/signup.hbs
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
    partials/footer.hbs
    partials/header.hbs
    partials/notifications.hbs
    partials/post-subscribe.hbs
    partials/search-form.hbs
    partials/sidebar/widget-recent-posts.hbs
    partials/sidebar/widget-subscribe.hbs
    partials/subscribe-form.hbs
    partials/tag-card.hbs
  [====]

  [====] New Files:
    locales/tr.json
    .github/workflows/deploy-theme.yml
  [====]
  ------------ VERSION - 1.5.6: Release on 19 Feb 2020 ------------
  [+] New: Ghost 3.0 support
  [+] IMPROVEMENT: General design
  [+] Fix: Ghosthunter search request to retrive post content and enable search on post content
  [+] Removed Instagram section. As of March 2nd, 2020, the Instagram platform will be deprecating its API. Aspire Instagram section is removed as access tokens depend on this API connect

  [====] Changed Files:
    .jshintignore
    assets/css/app.min.css
    assets/js/app.js
    assets/js/app.min.js
    assets/js/ghosthunter.js
    assets/sass/components/__all.scss
    assets/sass/components/_buttons.scss
    assets/sass/components/_content.scss
    assets/sass/components/_footer.scss
    assets/sass/components/_post.scss
    assets/sass/components/_share.scss
    assets/sass/components/_subscribe.scss
    assets/sass/components/_tags.scss
    assets/sass/components/_widget-instagram.scss
    assets/sass/elements/__all.scss
    assets/sass/elements/_hr.scss
    assets/sass/generic/__all.scss
    assets/sass/settings/_colors.scss
    assets/sass/trumps/__all.scss
    bower.json
    default.hbs
    gulpfile.js
    locales/da.json
    locales/de.json
    locales/du.json
    locales/en.json
    locales/es.json
    locales/fi.json
    locales/fr.json
    locales/it.json
    locales/pt.json
    members/account.hbs
    members/signin.hbs
    members/signup.hbs
    package-lock.json
    package.json
    page.hbs
    partials/compiled/inline-css.hbs
    partials/footer.hbs
    partials/header.hbs
    partials/loop.hbs
    partials/post-subscribe.hbs
    partials/share.hbs
    partials/sidebar.hbs
    partials/sidebar/widget-subscribe.hbs
    post.hbs
  [====]

  [====] New Files:
  routes.yaml
    members/account.hbs
    members/signin.hbs
    members/signup.hbs
    partials/signup-plans.hbs
    partials/subscribe-form.hbs
    partials/notifications.hbs
    partials/post-upgrade-cta.hbs
    assets/sass/trumps/_alerts.scss
    assets/sass/trumps/_link.scss
    assets/sass/trumps/_spacing.scss
    assets/sass/elements/_lists.scss
    assets/sass/components/_member-plan.scss
    assets/sass/components/_notifications.scss
    assets/sass/components/_post-upgrade-cta.scss
  [====]

  [====] Deleted Files:
    assets/js/instagram.js
    assets/sass/components/_widget-instagram.scss
    assets/sass/generic/_normalize.scss
    assets/sass/generic/_shared.scss
    partials/subscribe_form.hbs
    subscribe.hbs
    partials/sidebar/widget-instagram.hbs
  [====]
  ------------ VERSION - 1.5.5: Release on 16 Oct 19 ------------
  [+] FIX: Fix kg-bookmark-publisher class installation issue

  [====] Changed Files:
    assets/css/app.min.css
    assets/sass/components/_bookmark-card.scss
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------ VERSION - 1.5.4: Release on 28 Sep 19 ------------
  [+] IMPROVEMENT: Optimized search performance and fixed subdirectory search URL

  [====] Changed Files:
    assets/js/app.js
    assets/js/app.min.js
    assets/js/ghosthunter.js
    default.hbs
    package.json
  [====]
  ------------ VERSION - 1.5.3: Release on 3 Sep 19 ------------
  [+] New: Support for bookmark card
  [+] IMPROVEMENT: General design improvments

  [====] Changed Files:
    error.hbs
    package.json
    partials/footer.hbs
    partials/header.hbs
    partials/search-form.hbs
    partials/share.hbs
    partials/sidebar/widget-social.hbs
    partials/social-nav.hbs
    subscribe.hbs
  [====]
  ------------ VERSION - 1.5.2: Release on 14 April 19 ------------
  [+] FIXED: Ghost @site validation issues. The {{@blog}} helper should be replaced with {{@site}}. With the introduction of the Content API {{@blog}} became deprecated in favour of {{@site}}. The {{@blog}} helper will be removed in next version of Ghost and should not be used.
  [+] IMPROVEMENT: The included documentation is now updated to match the online one.

  [====] Changed Files:
    error.hbs
    package.json
    partials/footer.hbs
    partials/header.hbs
    partials/search-form.hbs
    partials/share.hbs
    partials/sidebar/widget-social.hbs
    partials/social-nav.hbs
    subscribe.hbs
  [====]
  ------------ VERSION - 1.5.1: Release on 5 February 19 ------------
  [+] IMPROVEMENT: Updated to Gulp 4
  [+] FIXED: Search and compatibility with Content API

  [====] Changed Files:
    assets/js/app.js
    assets/js/app.min.js
    assets/js/ghosthunter.js
    default.hbs
    gulpfile.js
    package-lock.json
    package.json
  [====]
  ------------ VERSION - 1.5.0: Release on 13 Sep 2018 ------------
  [+] New: Support for Koenig Gallery

  [====] Changed Files:
    assets/css/app.min.css
    assets/js/app.js
    assets/js/app.min.js
    assets/sass/components/_content.scss
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------ VERSION - 1.4.9: Release on 29 August 2018 ------------
  [+] New: Ghost 2.0 Support

  [====] Changed Files:
    assets/css/app.min.css
    assets/sass/components/_content.scss
    author.hbs
    error.hbs
    package-lock.json
    package.json
    page.hbs
    partials/author.hbs
    partials/compiled/inline-css.hbs
    partials/post-card.hbs
    partials/related-posts.hbs
    partials/sidebar/post-card.hbs
    partials/sidebar/widget-recent-posts.hbs
    post.hbs
  [====]
  ------------  VERSION - 1.4.8: Release on 5 June 2018  ------------
  [+] New: Added Translation Support for German, Spanish, French, Portuguese, Italian, Finnish, Dutch, and Danish
  [+] New: Support and improved search for RU, FR, ES, and DE languages
  [+] New: Added responsive video support for Twitch, Dailymotion, and Facebook
  [+] New: Added responsive tables style
  [+] IMPROVEMENT: Improved search section design
  [+] IMPROVEMENT: General design improvements
  ------------  VERSION - 1.4.7: Release on 26 November 2017  ------------
  [+] IMPROVEMENT: SEO enhancements
  [+] IMPROVEMENT: Images transitions
  [+] IMPROVEMENT: Buttons border radius in Google Chrome
  ------------  VERSION - 1.4.6: Release on 20 November 2017  ------------
  [+] FIXED: The search engine to search content for Ghost 1.0
  ------------  VERSION - 1.4.5: Release on 6 Oct 2017  ------------
  [+] FIXED: Accessibility issues
  [+] FIXED: Instagram image feed image width
  [+] FIXED: Code block responsive
  ------------  VERSION - 1.4.4: Release on 27 Sept 2017  ------------
  [+] FIXED: Related posts issue, check before showing the section heading
  ------------  VERSION - 1.4.3: Release on 11 Sept 2017  ------------
  [+] IMPROVEMENT: Link underline border selection style in post page
  ------------  VERSION - 1.4.2: Release on 30 July 2017  ------------
  [+] New: Added support to Ghost 1.0 🎉
  [+] IMPROVEMENT: Instagram feed is now configured with instafeedjs
  ------------  VERSION - 1.4.1: Release on 14 July 2017  ------------
  [+] IMPROVEMENT: Added the post image to the Pinterest sharing button URL. Thanks Jeff :)
  ------------  VERSION - 1.4.0: Release on 21 May 2017  ------------
  [+] New: Added responsive video support for TED videos
  [+] IMPROVEMENT: Typography visual improvements with consistent line height in style.
  ------------  VERSION - 1.3.9: Release on 17 May 2017  ------------
  [+] FIXED: Search and off-canvas issues with IE
  [+] FIXED: Off-canvas close button design
  ------------  VERSION - 1.3.8: Release on 26 April 2017  ------------
  [+] IMPROVEMENT: General code optimization and cleaning
  [+] IMPROVEMENT: Add new classes to font weight and style the footer blog name
  ------------  VERSION - 1.3.7: Release on 25 April 2017  ------------
  [+] New: Custom 404 page design
  [+] New: Added Pinterest share button
  [+] New: Added syntax highlighting for source code
  [+] New: Added tags page for listing all tags with images
  [+] IMPROVEMENT: General design improvements and code optimization for more clean UI and speed in performance
  ------------  VERSION - 1.3.6: Release on 4 April 2017  ------------
  [+] IMPROVEMENT: Extended search to search in pages
  ------------  VERSION - 1.3.5: Release on 24 Feb 2017  ------------
  [+] IMPROVEMENT: General Sass code cleaning for more quality and organized code
  ------------  VERSION - 1.3.4: Release on 21 Feb 2017  ------------
  [+] FIXED: Twitter timeline embedding
  ------------  VERSION - 1.3.3: Release on 20 Feb 2017  ------------
  [+] New: Updated Search to work with the new API to show all the articles when search with a specific keyword
  [+] New: Updated social media icons which included the new Instagram icon design
  ------------  VERSION - 1.3.2: Release on 15 Feb 17  ------------
  [+] Updated Instagram widget preview
  ------------  VERSION - 1.3.1: Release on 28 November 16  ------------
  [+] Fix featured post card title size
  [+] Fix sidebar recent posts style in medium screens
  ------------  VERSION - 1.3.0: Release on 8 November 16  ------------
  [+] Maximum performance optimization (99/100) for Google Page Speed test
  [+] Show off-canvas menu on medium screens
  [+] Added inline CSS for performance
  [+] Added Bower as a package manager to assets
  [+] Used Born font as the main font
  ------------  VERSION - 1.1.9: Release on 17 October 16  ------------
  [+] Added related posts feature with native Ghost solution
  [+] Compatible with Ghost 0.11.1
  ------------  VERSION - 1.1.8: Release on 4 August 16  ------------
  [+] Update to Ghost 8.0
  [+] Fix Safari (iPad) post card list layout issue
  [+] General small fixes and code refactoring
  ------------  VERSION - 1.2.7: Release on 17 June 16  ------------
  [+] Fix logo image height in large screens
  [+] Fix header social icons line-height
  ------------  VERSION - 1.2.6: Release on 8 June 16  ------------
  [+] Custom logo support
  [+] Enhance search section design
  ------------  VERSION - 1.2.5: Release on 8 May 16  ------------
  [+] Fix webkit appearance for input elements
  [+] Fix the auto generated stings generated by a Ghost issue by fixing the error page
  ------------  VERSION - 1.2.4: Release on 28 April 16  ------------
  [+] Fix tags margin
  [+] Remove hover border from logo
  [+] Edit Twitter follow text
  [+] Add gray placeholder background to related posts images
  ------------  VERSION - 1.2.3: Release on 21 April 16  ------------
  [+] Separate script.js file from the main JS file for easier script editing
  ------------  VERSION - 1.2.2: Release on 27 Mars 16  ------------
  [+] Fix schema data for post and author when share on Facebook
  ------------  VERSION - 1.2.1: Release on 4 Mars 16  ------------
  [+] Fix Twitter Widget to fetch tweets properly
  ------------  VERSION - 1.2: Release on 23 February 16  ------------
  [+] Enhance typography to be more simple and light, small JS and CSS refactoring
  [+] Show post meta in the first post in home page (Author + Publish Date)
  [+] Fix typo in the tag show page
  ------------  VERSION - 1.1: Release on 28 January 16  ------------
  [+] Fix un-styled content when page load issue
  ------------  VERSION - 1.0: Release on 24 December 15  ------------
  [+] Initial Release

Have any questions? Contact Ahmad