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.1.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 [+] Fix: Sidebar Author card image and content alignment in Firefox [+] 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: package-lock.json package.json page.hbs post.hbs error.hbs default-wide.hbs default.hbs assets/css/style-min-rtl.css assets/css/style-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/components/_card-author-mini.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/ro.json locales/tr.json members/account.hbs members/signin.hbs members/signup.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/footer.hbs partials/header.hbs partials/loop.hbs partials/member-plans.hbs partials/page-upgrade-cta.hbs partials/post-card.hbs partials/post-upgrade-cta.hbs partials/sidebar-authors.hbs partials/sidebar-featured-posts.hbs partials/sidebar-subscribe-form.hbs
------------ VERSION - 1.0.9: Release on 05 March 2021 ------------ [+] NEW: Romanian translation. Thanks, Daniel! [+] Improve: Italian translation. Thanks to Federico! [+] Improve: Turkish email translation [+] Improve: Bookmark card and table design [+] Added outline to buttons for Accessibility [+] Improve: Source code blocks are now responsive. No text breaks, and now scrollable. Thanks, Ben! [+] Fix: Sidebar subscribe widget title word breaking for long words [+] Fix: Author Twitter icon alignment New Files: locales/ro.json Changed Files: package.json package-lock.json assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_bookmark-card.scss assets/sass/components/_card-author.scss assets/sass/components/_content.scss assets/sass/components/_subscribe.scss assets/sass/elements/_code.scss assets/sass/elements/_tables.scss assets/sass/components/_buttons.scss locales/it.json locales/tr.json partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs
------------ VERSION - 1.0.8: Release on 16 December 2020 ------------ [+] Update: ISO code for the Dutch language in search [+] Update: Rename the Dutch language translation file name to nl.json instead of du.json [+] Fix: Fixed search date. Now using the published date instead of the created date. Thanks, Klevin! [+] Fix: Missing translation for the sidebar form `Newsletter` heading [+] Fix: Missing translation for the membership plans `Free` word [+] Fix: Missing Arabic translation for header `Log out` word and other grammar improvements New Files: locales/nl.json Deleted Files: locales/du.json Changed Files: .jshintignore assets/js/app.min.js assets/js/ghosthunter.js gulpfile.js 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/pt.json locales/tr.json package-lock.json package.json
------------ VERSION - 1.0.7: Release on 3 December 2020 ------------ [+] Improve: General design improvements. Small details matter [+] Improve: Typography improvements for content elements (UL, OL) [+] Improve: Responsive images performance [+] Improve: Inter font loading performance Now, the font is served from Google Fonts CDN instead of loading the font locally [+] Improve: Added explicit `width` and `height` attributes to images to avoid Cumulative Layout Shift [+] Improve: Membership text copywriting improvements. For example, `Log in` instead of `Log In` [+] Improve: Used CSS `max-height` to control the logo image instead of `max-width`. This makes resizing the logo more flexible. Consider reviewing your logo size after this update. Docs: https://aspirethemes.com/docs/krabi#customize-logo-size [+] Improve: Search result post date to be capitalized instead of uppercase. Consistency with other theme date format [+] Update: NPM packages [+] Update: The tooltips CSS package to use the new repo (@primer/css) [+] Update: Deploy Ghost Theme Github action config file [+] Fix: Translation for the `Newsletter` word in the site footer Around 15% to 20% overall performance increase with Google Page Speed New Files: partials/fonts.hbs Deleted Files: assets/fonts/inter/Inter-italic.var.woff2 assets/fonts/inter/Inter-roman.var.woff2 assets/sass/settings/_fonts.scss Changed Files: README.md .github/workflows/deploy-theme.yml assets/css/style-min-rtl.css assets/css/style-min.css assets/js/app.js assets/js/app.min.js assets/sass/components/_author.scss assets/sass/components/_bookmark-card.scss assets/sass/components/_card-tag.scss assets/sass/components/_content.scss assets/sass/components/_logo.scss assets/sass/components/_post-card.scss assets/sass/components/_post-header.scss assets/sass/components/_search.scss assets/sass/components/_social-icons.scss assets/sass/components/_tags-list.scss assets/sass/components/_teaser.scss assets/sass/settings/__all.scss assets/sass/settings/_colors.scss assets/sass/settings/_fonts.scss assets/sass/settings/_grid.scss assets/sass/settings/_type.scss assets/sass/vendor/__all.scss author.hbs locales/ar.json 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/signin.hbs members/signup.hbs package-lock.json package.json partials/card-author-mini.hbs partials/card-author.hbs partials/card-tag.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/footer.hbs partials/head.hbs partials/header.hbs partials/member-plans.hbs partials/page-upgrade-cta.hbs partials/post-card.hbs partials/post-header.hbs partials/post-upgrade-cta.hbs partials/sidebar-social-icons.hbs partials/teaser.hbs
------------ VERSION - 1.0.6: Release on 14 October 2020 ------------ [+] New: Turkish translation [+] Improve: Background color for zoomed images [+] Improve: Code quality [+] Improve: Table design by adding a white background to be more visible [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_header.scss assets/sass/components/_search.scss assets/sass/elements/_code.scss assets/sass/elements/_input.scss assets/sass/elements/_tables.scss assets/sass/settings/_colors.scss assets/sass/vendor/_image-zoom-custom.scss package-lock.json package.json partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs [====] [====] New Files: locales/tr.json [====]
------------ VERSION - 1.0.5: Release on 24 September 2020 ------------ [+] Improve: Content typography and embedded iframe improvements [+] Improve: Remove white background from Twitter and Instagram embeds [+] Improve: Search results typography style [+] Improve: Commento commenting box design improvement [+] Fix: Commento MARKDOWN preview styling issues [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_content.scss assets/sass/components/_kg-card.scss assets/sass/components/_search.scss assets/sass/elements/_blockquote.scss assets/sass/vendor/__all.scss package-lock.json package.json partials/commento.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs [====] [====] New Files: assets/sass/vendor/_commento.scss [====]
------------ VERSION - 1.0.4: Release on 02 September 2020 ------------ [+] Fix: Gulp zip script to include hidden files that are used in and help in development mode. Thanks, Daniel! [+] Improve: Search close icon design. Thanks, Matthew! [+] Improve: Add loading indicator for Subscribe buttons. This will improve the user experience as the connection between Ghost and Stripe might take a second. This will also remove the confusion that clicking the button didn't work from the first time. Thanks, Angus! [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_buttons.scss assets/sass/components/_kg-card.scss assets/sass/components/_post-card.scss assets/sass/components/_search.scss assets/sass/elements/_input.scss gulpfile.js package-lock.json package.json partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.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.0.3: Release on 11 August 2020 ------------ [+] Fix: Tags page tag card title margin-bottom issue [+] Improve: Subscribe page layout width if the user is logged in. [+] Improve: Hide footer secondary navigation title if there is no secondary navigation items [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_card-tag.scss members/subscribe.hbs package-lock.json package.json partials/card-tag.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/footer.hbs partials/header.hbs [====]
------------ VERSION - 1.0.2: Release on 20 July 2020 ------------ [+] Improve: Markup for posts page [+] Improve: Post text readability [+] Improve: Added blog URL to the authors sidebar link [+] Improve: Comments section design [+] Improve: Show the featured posts section only if there are featured posts exist [+] Fix: Author image in the author card when the image does not exist [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/_content.scss assets/sass/components/_post-card.scss default-wide.hbs default.hbs package-lock.json package.json page.hbs partials/card-author-mini.hbs partials/card-author.hbs partials/commentbox.hbs partials/commento.hbs partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/disqus.hbs partials/post-header.hbs partials/sidebar-authors.hbs partials/sidebar-featured-posts.hbs post.hbs [====]
------------ VERSION - 1.0.1: Release on 29 June 2020 ------------ [+] Fix: Bookmark card text underline. [+] Fix: Post date issue. Thanks Maxence! [+] Fix: Theme CSS validation issue. [+] Improve: Added French translation to the `Latest` word in the tags menu. [====] Changed Files: assets/css/style-min-rtl.css assets/css/style-min.css assets/sass/components/__all.scss assets/sass/components/_bookmark-card.scss assets/sass/components/_gallery.scss assets/sass/components/_kg-card.scss assets/sass/components/_subscribe.scss assets/sass/components/_widget.scss locales/fr.json package-lock.json package.json partials/compiled/inline-css-rtl.hbs partials/compiled/inline-css.hbs partials/post-card.hbs partials/post-header.hbs [====] [====] Deleted Files: assets/css/dark-min.css assets/css/dark-min-rtl.css assets/sass/components/_related.scss [====]
------------ VERSION - 1.0.0: Release on 15 June 2020 ------------ [+] 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!