Backup your current theme first
Please backup your current used theme before updating to a new version.
- Log in to your Ghost admin
- Go to Settings > Theme > Installed Themes
- Download your active theme
First, download the new theme version from the email you received about the theme update. If you lost the email or the download link, click here for more details.
To update your current theme to the new version, copy and replace the below listed Changed Files from the new theme version to your theme.
In case of any listed Deleted Files, safely remove the files from your theme.
In case of any listed New Files, copy the files to your theme with the same file path.
Copying a file from the new version to your theme will override it. You could redo your changes only if the file received an update.
Watch the following short video for a quick tutorial.
I always recommend updating your theme to the latest theme version to avoid future Ghost compatibility and API depreciation issues. Also, it will be easier to update to future theme updates too.
In case you encounter any issue while updating the theme, do/double-check the following:
- Deactivate and activate the theme again
- Upload the new/fresh theme version to see if the problem is from your theme or the new version
- Restart Ghost
- Make sure you uploaded the
routes.yamlfile if it is updated in the new theme version
- Make sure you updated all the mentioned files in the changelog below
------------ Version: 1.0.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: 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. Deleted Files: partials/notifications.hbs assets/sass/components/_notifications.scss Changed Files: archive.hbs default.hbs error.hbs page.hbs post.hbs home.hbs home-image-center.hbs home-image-circle.hbs home-image-full.hbs home-image-right.hbs home-image-wide.hbs package-lock.json package.json assets/css/style-min-rtl.css assets/css/style-min.css assets/js/app.js assets/js/app.min.js assets/sass/components/__all.scss assets/sass/components/_content.scss assets/sass/components/_bookmark-card.scss assets/sass/components/_post-card.scss assets/sass/components/_post-header.scss assets/sass/elements/_input.scss assets/sass/trumps/_spacing.scss locales/ar.json 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/membership.hbs members/signin.hbs members/signup.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/home/featured-posts.hbs partials/home/recent-posts.hbs partials/loop.hbs partials/header.hbs partials/membership-plans.hbs partials/membership-upgrade.hbs partials/post-card.hbs partials/subscribe-box.hbs
------------ VERSION - 1.0.1: Release on 05 March 2021 ------------ [+] NEW: Added `Skip to content` link. An accessibility enhancement for site navigation with a keyboard. When using a keyboard to navigate the website, the `Skip to content` link will enable you to skip the navigation and go directly to the main content area. This is useful if people are only using the keyboard or using a screen-reader to navigate your website. [+] NEW: Added posts count to the Archive page tags [+] Improve: Source code blocks are now responsive. No text breaks, and now scrollable. [+] Improve: Table design by adding a background color to be more visible [+] Improve: Remove the `All Posts` homepage button if there are no published posts [+] Improve: Add `title` attribute to header icons and an alternative text for screen readers [+] Fix: Pages meta title tag for Blog and Archive pages [+] Fix: Author Twitter icon alignment [+] Fix: Theme body horizontal scroll issue when a wide image inserted in a post New Files: assets/sass/components/_skip.scss assets/sass/components/_drop-cap.scss Changed Files: home.hbs index.hbs page.hbs post.hbs tag.hbs error.hbs author.hbs default.hbs archive.hbs home-image-center.hbs home-image-circle.hbs home-image-full.hbs home-image-right.hbs home-image-wide.hbs bower.json gulpfile.js package.json package-lock.json .jshintignore assets/js/app.min.js assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/__all.scss assets/sass/components/_card-archive.scss assets/sass/components/_card-author.scss assets/sass/components/_content.scss assets/sass/components/_kg-card.scss assets/sass/components/_nav.scss assets/sass/components/_pagination.scss assets/sass/components/_post-card.scss assets/sass/components/_post-header.scss assets/sass/components/_post.scss assets/sass/elements/_body.scss assets/sass/elements/_code.scss assets/sass/elements/_tables.scss assets/sass/trumps/_type.scss locales/ar.json 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/membership.hbs members/signin.hbs members/signup.hbs partials/head.hbs partials/post-header.hbs partials/social-icons.hbs partials/home/all-posts-link.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs
------------ VERSION - 1.0.0: Release on 22 Jan 2021 ------------ [+] Initial Release
Your feedback is very welcome ♥
I'm open to your feedback and to hear about your experience. If you have about one minute, please send your thoughts through this Google Form ↗.
Thank you for your time!