Skip to content

Theme version: 1.3.3 — 08 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.3.3: Release on 8 June 2022

New

  1. Ghost 5.0 support
  2. East 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

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

/locales/

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

------------  Version: 1.3.2 — 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
[+] Improve: Log in and membership text copywriting
[+] Fixe: List items spacing issue and bookmark card missing dot. Thanks, Max!
[+] 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:
  post.hbs
  default.hbs
  error.hbs
  gulpfile.js
  package-lock.json
  package.json
  .jshintignore

  .github/workflows/deploy-theme.yml

  assets/css/style.min.css

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

  assets/sass/base/_reset.scss
  assets/sass/components/__all.scss
  assets/sass/components/_meta.scss
  assets/sass/sections/_post.scss
  assets/sass/base/_typography.scss
  assets/sass/components/_bookmark-card.scss

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

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

  partials/compiled/inline-css.hbs
  partials/loop.hbs

  partials/post-upgrade-cta.hbs
  partials/sidebar.hbs
  partials/signup-plans.hbs
  partials/subscribe-form.hbs
  ------------  VERSION - 1.3.1: 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!
  [+] Fix: Bookmark card icon right margin
  [+] Fix: Tag card title margin issue. Thanks Max!

  [====] Changed Files:
    assets/css/style.min.css
    assets/sass/base/__all.scss
    assets/sass/base/_typography.scss
    assets/sass/components/_bookmark-card.scss
    assets/sass/components/_buttons.scss
    assets/sass/components/_code.scss
    assets/sass/components/_forms.scss
    assets/sass/components/_tag-card.scss
    assets/sass/sections/_post.scss
    assets/sass/variables/_colors.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/se.json
    locales/tr.json
    members/signup.hbs
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
    partials/sidebar.hbs
  [====]

  [====] New Files:
    assets/sass/base/_reset.scss

    ----
    NOTE: The following 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/base/normalize.css
  [====]
  ------------  VERSION - 1.3.0: Release on 11 August 2020  ------------
  [+] Fix: Sign-in and Signup form width
  [+] Fix: Subscribe form button layout
  [+] Fix: Pinterest icon color

  Thanks Max for all your suggestions and feedback!

  [====] Changed Files:
    assets/css/style.min.css
    assets/sass/sections/_post.scss
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------  VERSION - 1.2.9: Release on 20 July 2020  ------------
  [+] Fix: Full-width image width

  [====] Changed Files:
    assets/css/style.min.css
    assets/sass/sections/_post.scss
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------  VERSION - 1.2.8: Release on 2 July 2020  ------------
  [+] Improve: Accessibility
  [+] New: Add Swedish translation. Thanks Max!
  [+] New: Add Turkish translation. Thanks Tolga!
  [+] New: Added 404 page
  [+] New: Added Pinterest share icon
  [+] Improve: Change page titles to H1 for SEO
  [+] Fix: Bookmark card dash issue
  [+] Fix: Mobile navigation issue
  [+] Fix: Content image alignments
  [+] Fix: Wider caption in full width and wide images to be aligned with the image
  [+] Improve: Search date format and search results style
  [+] New: Added integration with Deploy Ghost Theme Github action
  [+] New: Added gulp zip command to easily zip the theme

  Thanks Max for all your suggestions and feedback!

  [====] Changed Files:
    assets/css/style.min.css
    assets/js/app.js
    assets/js/app.min.js
    assets/js/ghosthunter.js
    assets/sass/components/_box.scss
    assets/sass/components/_media.scss
    assets/sass/components/_notifications.scss
    assets/sass/components/_post-card.scss
    assets/sass/helpers/__all.scss
    assets/sass/sections/_off-canvas.scss
    assets/sass/sections/_post.scss
    assets/sass/sections/_search.scss
    assets/sass/sections/_sidebar.scss
    author.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
    package-lock.json
    package.json
    page-tags.hbs
    page.hbs
    partials/compiled/inline-css.hbs
    partials/disqus.hbs
    partials/notifications.hbs
    partials/post-card.hbs
    partials/search-form.hbs
    partials/share.hbs
    partials/sidebar.hbs
    partials/subscribe-form.hbs
    post.hbs
    tag.hbs
  [====]

  [====] New Files:
    .github/workflows/deploy-theme.yml
    assets/sass/helpers/_visibility.scss
    error.hbs
    locales/se.json
    locales/tr.json
  [====]
  ------------ VERSION - 1.2.7: Release on 6 Nov 2019  ------------</strong>
  [+] New: Ghost 3.0 support

  [====] Changed Files:
    assets/css/style.min.css
    assets/js/app.js
    assets/js/app.min.js
    assets/sass/components/__all.scss
    assets/sass/components/_buttons.scss
    assets/sass/components/_forms.scss
    assets/sass/functions/__all.scss
    assets/sass/helpers/__all.scss
    assets/sass/variables/_colors.scss
    default.hbs
    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
    package.json
    partials/compiled/inline-css.hbs
    partials/loop.hbs
    partials/share.hbs
    partials/sidebar.hbs
    partials/subscribe-form.hbs
    post.hbs
  [====]

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

  [====] Deleted Files:
    subscribe.hbs
    partials/subscribe_form.hbs
  [====]
  ------------ VERSION - 1.2.6: Release on 16 Oct 2019  ------------</strong>
  [+] New: Support for bookmark card

  [====] Changed Files:
    assets/css/style.min.css
    assets/js/app.min.js
    assets/sass/components/__all.scss
    assets/sass/components/_bookmark-card.scss
    assets/sass/sections/_post.scss
    package-lock.json
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------ VERSION - 1.2.5: Release on 17 April 2019  ------------</strong>
  [+] 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: Added {{ @site.lang }} to the language attribute

  [====] Changed Files:
    default.hbs
    package-lock.json
    package.json
    partials/sidebar.hbs
    subscribe.hbs
  [====]
  ------------ VERSION - 1.2.4: Release on 6 February 2019  ------------</strong>
  [+] IMPROVEMENT: Typography and design improvements

  [====] Changed Files:
    assets/css/style.min.css
    assets/sass/base/_typography.scss
    assets/sass/helpers/_typography.scss
    assets/sass/sections/_post.scss
    package.json
    partials/compiled/inline-css.hbs
  [====]
  ------------ VERSION - 1.2.3: Release on 5 February 2019  ------------</strong>
  [+] FIXED: Search and compatibility with Content API

  [====] Changed Files:
    assets/js/app.js
    assets/js/app.min.js
    assets/js/ghosthunter.js
    package.json
  [====]
  ------------  VERSION - 1.2.2: Release on 5 Jan 2019  ------------
  [+] New: Ghost 2.0 full support
  [+] New: Added post reading time
  [+] New: Migrated to Gulp 4
  [+] New: Added syntax highlighter with Prism
  [+] New: Added Support for Ghost translation support for German, Spanish, French, Portuguese, Italian, Finnish, Dutch, and Danish translation
  [+] IMPROVEMENT: General design and typography improvements
  ------------  VERSION - 1.2.1: Release on 20 November 2017  ------------
  [+] FIXED: The search engine to search content for Ghost 1.0
  ------------  VERSION - 1.2.0: Release on 4 August 2017  ------------
  [+] New: Added support to Ghost 1.0
  ------------  VERSION - 1.1.9: Release on 4 April 2017  ------------
  [+] IMPROVEMENT: Extended search to search in pages
  ------------  VERSION - 1.1.8: Release on 19 March 2017  ------------
  [+] FIXED: Sidebar copyright text position on large screen
  ------------  VERSION - 1.1.7: Release on 20 Feb 2017  ------------
  [+] New: Added tags page for listing all tags with images
  [+] 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.1.6: Release on 8 November 2016  ------------
  [+] Maximum performance optimization (99/100) for Google Page Speed test
  [+] Added inline CSS for performance
  [+] Added Bower as a package manager to assets
  [+] Used Born font as the main font
  ------------  VERSION - 1.1.5: Release on 4 August 2016  ------------
  [+] Update to Ghost 8.0
  [+] Fix Safari (iPad) post card list layout issue
  [+] General small fixes and code refactoring
  ------------  VERSION - 1.1.4: Release on 8 June 2016  ------------
  [+] Enhance search section design
  [+] Simplify sidebar grey color
  [+] Fix video embed bottom margin
  [+] Logo Support
  ------------  VERSION - 1.1.3: Release on 8 May 2016  ------------
  [+] Fix tags margin
  [+] Fix webkit appearance for input elements and the round corners
  [+] Fix the auto generated stings generated by a Ghost issue by fixing the error page
  ------------  VERSION - 1.1.2: Release on 26 April 2016  ------------
  [+] Fix author and tag pages layout page in larger screens
  [+] Fix for logo text line height
  ------------  VERSION - 1.1.1: Release on 27 Mars 2016  ------------
  [+] Fix schema data for post and author when share on Facebook
  ------------  VERSION - 1.1: Release on 9 Mars 2016  ------------
  [+] Enhance typography to be more simple and light
  ------------  VERSION - 1.0: Release on 6 February 2016  ------------
  [+] Initial release

Have any questions? Contact Ahmad