DocsAspectUpdating Theme

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

  1. Always backup your current theme before updating to a new version
  2. Custom modifications warning: If youโ€™ve made custom changes to your theme files, updating will overwrite these modifications
  3. 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:

  1. Download the latest version of the theme
  2. 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:

  1. 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
  2. Document your custom changes
  3. Apply your modifications to the new theme version
  4. Follow the installation steps linked above

๐Ÿ’ก Pro Tips

  1. 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.

  2. 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.

  3. Version Compatibility: Always ensure the new theme version is compatible with your Ghost installation version.