Updating Theme
Theme updates are essential as they ensure compatibility with the latest Ghost version, improve performance, and fix bugs. This guide will help you update your theme safely and effectively.
Important Notes Before Updating
- Always backup your current theme before updating to a new version
- Custom modifications warning: If youโve made custom changes to your theme files, updating will overwrite these modifications
- Settings preservation tip: Always use the same filename (e.g.,
aspect.zip
) when uploading updates to preserve your Design & Branding settings
Method 1: Simple Update (No Custom Changes)
If you havenโt modified any theme files:
- Download the latest version of the theme
- Follow our theme installation guide to upload the new version
Method 2: Update with Custom Changes
If youโve modified your theme, youโll need to:
- Compare your current theme with the new version. Use one of the following methods:
- Use version control. GitHub is recommended for this method.
- Use a tool like Zip Compare Tool to identify changed files
- Document your custom changes
- Apply your modifications to the new theme version
- Follow the installation steps linked above
๐ก Pro Tips
-
Making Small Changes: For minor style adjustments, use the Ghost Code Injection feature instead of modifying theme files directly. These changes will persist through updates.
-
Asset Folder Updates: Pay special attention to the
assets
folder during updates, as it contains crucial style and script changes. This folder is typically rebuilt in new versions. -
Version Compatibility: Always ensure the new theme version is compatible with your Ghost installation version.