Repository navigation
Updating
This page explains how to update the Aegis theme to the latest version safely and efficiently.
Before performing any update, take the following precautions:
- Back up your site — Create a full backup of your database and files.
- Check the changelog — Review the release notes for breaking changes.
- Test in staging — If possible, test the update on a staging environment first.
- Check plugin compatibility — Ensure your companion plugins (Aegis Plugin, Aegis Pro) are compatible with the new theme version.
When a new version of Aegis is available, WordPress will display an update notification:
- Navigate to Dashboard → Updates.
- Locate Aegis in the themes section.
- Click Update Now.
- Wait for the update to complete.
- Verify your site is working correctly.
The automatic updater pulls releases directly from the GitHub repository.
If automatic updates are not available or you prefer manual control:
- Download the latest release
.zipfrom the GitHub Releases page. - Navigate to Appearance → Themes.
- Click Add New Theme and then Upload Theme.
- Select the downloaded
.zipfile. - Click Install Now.
- When prompted, choose Replace current with uploaded to overwrite the existing installation.
- Click Activate if the theme was deactivated during the process.
- Download and extract the latest release.
- Connect to your server via FTP.
- Navigate to
wp-content/themes/. - Rename the existing
aegisfolder toaegis-backup(as a safety measure). - Upload the new
aegisfolder. - Verify the site works correctly.
- Delete the
aegis-backupfolder once confirmed.
If you installed Aegis via Git:
cd wp-content/themes/aegis
git fetch origin
git checkout main
git pull origin main
composer install --no-dev
npm install
npm run buildIf you manage Aegis through Composer:
composer update aegiswp/themeWhen updating the theme, you should also check for updates to companion plugins:
| Plugin | Update Location |
|---|---|
| Aegis Plugin (free) | Plugins → Installed Plugins |
| Aegis Pro | Plugins → Installed Plugins or license portal |
Always update the theme and plugins together to ensure compatibility.
Aegis follows semantic versioning (SemVer):
| Version Change | Meaning | Action Required |
|---|---|---|
| Patch (1.0.x) | Bug fixes, no breaking changes | Safe to update immediately |
| Minor (1.x.0) | New features, backwards compatible | Review new features, safe to update |
| Major (x.0.0) | Breaking changes possible | Read migration guide before updating |
The following customizations are preserved when you update:
- Global Styles — Colors, typography, and layout changes made in the Site Editor.
- Template modifications — Custom templates created in the Site Editor.
- User-created patterns — Patterns you have created yourself.
- Database content — Posts, pages, and media are never affected.
- Plugin settings — Companion plugin configurations remain intact.
The following are overwritten during an update:
- Theme files — All PHP, JSON, and asset files in the theme directory.
- Default templates — Original templates are replaced with updated versions.
- Default patterns — Bundled patterns are replaced with updated versions.
Note: If you have modified theme files directly (not recommended), those changes will be lost during an update. Always use child themes or the Site Editor for customizations.
If an update fails:
- Check file permissions on the
wp-content/themes/directory. - Ensure sufficient disk space is available.
- Check the PHP error log for specific error messages.
- Try the manual FTP method as a fallback.
If your site does not work correctly after updating:
- Clear all caches (browser, plugin, server).
- Deactivate and reactivate the theme.
- Check Tools → Site Health for any reported issues.
- If the issue persists, restore your backup and report the issue on GitHub.
To revert to a previous version:
- Download the previous release from GitHub Releases.
- Follow the manual update process (Method 2 or Method 3) using the older version file.
To be notified of new releases:
- Watch the GitHub repository for release notifications.
- Follow @aegiswp on GitHub.
- Check the WordPress admin dashboard regularly for update badges.
- requirements — Verify your environment meets the latest requirements.
- common-issues — Solutions to common problems after updating.
Aegis version 1.0.0 | GitHub Repository | Report an Issue | Atmostfear Entertainment
License: GPL-2.0-or-later