Skip to content

Theme version: 1.3.1 — 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.1: Release on 8 June 2022

New

  1. Ghost 5.0 support
  2. Maxima 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.3.0 — 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
[+] 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
  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/_content.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/nl.json
  locales/pt.json
  locales/tr.json

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

  partials/compiled/inline-css.hbs
  partials/header.hbs
  partials/loop.hbs
  partials/post-upgrade-cta.hbs
  partials/signup-plans.hbs
  ------------  VERSION - 1.2.9: 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/sass/components/_content.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
  [====]
  ------------  VERSION - 1.2.8: Release on 20 July 2020  ------------
  [+] Improve: Accessibility
  [+] Improve: General design improve
  [+] New: Add content image zoom
  [+] 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: Video player margin bottom

  [====] 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/_embed.scss
    assets/sass/components/_notifications.scss
    assets/sass/components/_off-canvas.scss
    assets/sass/components/_post.scss
    assets/sass/elements/_image.scss
    assets/sass/elements/_page.scss
    assets/sass/settings/_colors.scss
    assets/sass/vendor/__all.scss
    assets/sass/vendor/_image-zoom-custom.scss
    bower.json
    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/disqus.hbs
    partials/footer.hbs
    partials/header.hbs
    partials/notifications.hbs
    partials/search-form.hbs
    partials/subscribe-form.hbs
  [====]

  [====] New Files:
    locales/tr.json
    .github/workflows/deploy-theme.yml
  [====]
  ------------  VERSION - 1.2.7: Release on 1 Jan 2019  ------------
  [+] New: Ghost 3.0 full support
  [+] Improve: General Design and Typography
  [+] Fix: Search when the site is served in a directory

  [====] Changed Files:
    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/_blog-desc.scss
    assets/sass/components/_bookmark-card.scss
    assets/sass/components/_buttons.scss
    assets/sass/components/_content.scss
    assets/sass/components/_logo.scss
    assets/sass/components/_nav.scss
    assets/sass/components/_pagination.scss
    assets/sass/components/_post-card.scss
    assets/sass/components/_post.scss
    assets/sass/components/_search.scss
    assets/sass/components/_subscribe.scss
    assets/sass/components/_tag-card.scss
    assets/sass/components/_tag.scss
    assets/sass/components/_tags.scss
    assets/sass/elements/__all.scss
    assets/sass/elements/_blockquote.scss
    assets/sass/elements/_code.scss
    assets/sass/elements/_input.scss
    assets/sass/elements/_links.scss
    assets/sass/elements/_page.scss
    assets/sass/elements/_tables.scss
    assets/sass/generic/__all.scss
    assets/sass/settings/_colors.scss
    assets/sass/trumps/__all.scss
    assets/sass/trumps/_link.scss
    assets/sass/trumps/_type.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-lock.json
    package.json
    partials/compiled/inline-css.hbs
    partials/footer.hbs
    partials/header.hbs
    partials/loop.hbs
    partials/navigation.hbs
    partials/subscribe-form.hbs
    post.hbs
  [====]

  [====] New Files:
    assets/sass/components/_archive.scss
    assets/sass/components/_member-plan.scss
    assets/sass/components/_notifications.scss
    assets/sass/components/_post-upgrade-cta.scss
    assets/sass/elements/_lists.scss
    assets/sass/trumps/_alerts.scss
    assets/sass/trumps/_link.scss
    assets/sass/trumps/_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
    assets/sass/generic/_shared.scss
    assets/sass/generic/_normalize.scss
  [====]
  ------------  VERSION - 1.2.6: Release on 22 Dec 2019  ------------
  [+] Fix: Fixed custom tags page

  [====] Changed Files:
    package.json
    page-tags.hbs =(rename to)> custom-tags.hbs
  [====]
  ------------  VERSION - 1.2.5: Release on 16 Oct 2019  ------------
  [+] New: Support for bookmark card

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

  [====] Changed Files:
    default.hbs
    error.hbs
    package-lock.json
    package.json
    partials/footer.hbs
    partials/header.hbs
    partials/search-form.hbs
    partials/share.hbs
    subscribe.hbs
  [====]
  ------------  VERSION - 1.2.3: Release on 5 February 2019  ------------
  [+] Improve: Updated to Gulp 4
  [+] Fix: 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.2.2: Release on 13 Sep 2018  ------------</strong>
  [+] 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.2.1: Release on 25 August 2018  ------------</strong>
  [+] New: Ghost 2.0 Support
  [+] Fix: Content width in small screens

  [====] Changed Files:
    assets/css/app.min.css
    assets/sass/components/_content.scss
    assets/sass/objects/_grid.scss
    author.hbs
    error.hbs
    package.json
    partials/author.hbs
    partials/compiled/inline-css.hbs
    post.hbs
  [====]
  ------------  VERSION - 1.2.0: Release on 9 August 2018  ------------
  [+] New: Added new error custom page
  [+] New: Added Dailymotion and Facebook responsive video support
  [+] Improvement: Focus and open keyboard for iPhone Mobile Safari

  [====] Changed Files:
    error.hbs
    package.json
    assets/js/app.js
    assets/js/app.min.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
  [====]
</pre>

  ------------  VERSION - 1.1.9: Release on 20 May 2018  ------------
  [+] Fix: Fix Twitch Responsive Embed
</pre>

  ------------  VERSION - 1.1.8: Release on 16 May 2018  ------------
  [+] New: Added posts count to the tag card
  [+] Improvement: Improved search section design
  [+] Improvement: Support and improved search for German, Spanish, French, Portuguese, Italian, Finnish, Dutch, and Danish
  [+] New: Added Support for Ghost translation with German, Spanish, French, Portuguese, Italian, Finnish, Dutch, and Danish translation
  [+] Added responsive support for Twitch
  [+] Improvement: General improvments
</pre>

  ------------  VERSION - 1.1.7: Release on 23 November 2017  ------------
  [+] Improve: Footer sections spacing.
  [+] Improve: Transition for the search modal.
  [+] Fix: Author section style.
</pre>

  ------------  VERSION - 1.1.6: Release on 20 November 2017  ------------
  [+] Fix: The search engine to search content for Ghost 1.0
</pre>

  ------------  VERSION - 1.1.5: Release on 6 Oct 2017 ------------
  [+] Fix: Accessibility issues
  [+] Fix: Code block responsive
  [+] Fix: Content text break for long URLs
</pre>

  ------------  VERSION - 1.1.4: Release on 11 Sept 2017  ------------
  [+] Improve: Link underline border selection style in post page
</pre>

  ------------  VERSION - 1.1.3: Release on 6 August 2017  ------------
  [+] Fix: Code block style that is used without prisim.js
</pre>

  ------------  VERSION - 1.1.2: Release on 31 July 2017  ------------
  [+] New: Added support to Ghost 1.0
  [+] New: Added new share icon for Pinterest
</pre>

  ------------  VERSION - 1.1.1: Release on 25 May 2017  ------------
  [+] New: Added syntax highlighting for source code
  [+] Improve: Close the sidebar when the screen is clicked
</pre>

  ------------  VERSION - 1.1.0: Release on 18 May 2017  ------------
  [+] Improve: Typography visual improvements with consistent line height in style.
  [+] Improve: Navigation style
</pre>

  ------------  VERSION - 1.0.9: Release on 17 May 2017  ------------
  [+] New: Added responsive video support for TED videos
  [+] Fix: Internet Explorer 11 layout fixes
  [+] Improve: Improved sidebar design by adding an icon to close it with wider width
</pre>

  ------------  VERSION - 1.0.8: Release on 13 April 2017  ------------
  [+] Improve: Link underline border style in post page
  [+] Improve: Make post content less in width for readability
  [+] Fix: Featured image alignment in post page
</pre>

  ------------  VERSION - 1.0.7: Release on 4 April 2017  ------------
  [+] Improve: Extended search to search in pages
</pre>

  ------------  VERSION - 1.0.6: Release on 9 March 2017  ------------
  [+] Fix: Code element width issue for small screens.
  [+] Improve: Updated documentation for search
</pre>

  ------------  VERSION - 1.0.5: Release on 15 Feb 2017  ------------
  [+] Fix: Strong element style to be visually bold
</pre>

  ------------  VERSION - 1.0.4: Release on 25 Jan 2017  ------------
  [+] New: Updated Search to work with the new API to show all the articles when search with a specific keyword
  [+] New: Improve the design of the post date in single page
</pre>

  ------------  VERSION - 1.0.3: Release on 22 Jan 2017  ------------
  [+] Fix: Search layout issue in small screen
</pre>

  ------------  VERSION - 1.0.2: Release on 9 Jan 2017  ------------
  [+] New: Added blog description to sidebar
  [+] New: Added new designed page for tags
</pre>

  ------------  VERSION - 1.0.1: Release on 20 Dec 2016  ------------
  [+] New: Added post image to post page
  [+] Fix: Page content width in small screens
  [+] Fix: Input style for select element
</pre>

  ------------  VERSION - 1.0.0: Release on 5 Dec 2016  ------------
  [+] Initial Release
</pre>

Have any questions? Contact Ahmad