⚑ 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
If you made no changes to your current theme files, download the latest theme version and upload it to your website—no need to worry about updating the files in the following steps.
First, download the new theme version from the theme update email. If you 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 any New Files are listed, copy the files to your theme with the same file path.
Copying a file from the new version to your theme will override your file.
Redo your customizations only if that file receives an update.
If you did CSS customizations in Code Injection, there is no need to worry about these unless I mention any CSS changes.
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.
If you missed updating a version, for example, your current theme is 1.0.0, and the latest one is 1.0.2, does it mean you need the middle 1.0.1 version to update your current version? No. Instead, use the newest version (1.0.2) as a base for the 1.0.1 changelog. 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.
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: Release on 5 Oct 2022
Please make sure you have the latest version of Ghost before upgrading. This is required for the comments and search to work.
- Added Ghost Native Comments (docs).
- Added Ghost Native Search (docs).
- Dropdown menu support (docs).
- Ability to hide all the theme membership interface elements from the admin (docs)
- General design and typography fixes/improvements
package.json partials/card-post.hbs partials/css/dist/style-rtl.hbs partials/css/dist/style.hbs partials/home/intro.hbs partials/navigation.hbs partials/newsletter-section.hbs partials/page-header.hbs partials/structure/header.hbs post.hbs /locales/ (Copy all the `/locales/` folder and override your current theme one.) /assets/sass/ (Copy all the `/sass/` folder and override your current theme one. Too many files changed here, so it’s easier to do this instead of doing it one by one.)
VERSION - 1.0.1: Release on 24 May 2022
- Ghost 5.0 support
- Added reading time to posts
- Updated Ghost Deploy Action version
- Twitter embeded card alignment in small screens
package.json partials/card-post.hbs partials/page-header.hbs partials/upgrade.hbs partials/css/dist/style-rtl.hbs partials/css/dist/style.hbs .github/workflows/deploy-theme.yml /locales/ (Copy all the `/locales/` folder and override your current theme one.)
.github/workflows/deploy-theme.yml file is for the GitHub Deploy Action. It is part of the theme, but since the folder starts with a dot ( .github ) it might be hidden on your computer. No worries if you are not using GitHub for theme deployment.)
VERSION - 1.0.0: Release on 20 Feb 2022
Have any questions? I’m here to help.Contact Ahmad