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.