On this page
Guides
Upgrading from earlier versions of Clay, and solutions for common problems.
#Which guide do I need?
| Your site runs on | Follow, in this order |
|---|---|
| Clay 3 | Clay 4 |
| Clay 2 | Clay 3, then Clay 4 |
| Clay 1 with Clay Oven | Clay 2, then Clay 3, then Clay 4 |
Not sure which version you run? npx clay --version tells you.
#Before you upgrade
- Commit your work, so the upgrade is one change you can review and undo.
- Read the guide for the next version, and its “At a glance” table.
- Upgrade one major version at a time, and finish each guide with
npx clay build --strict: when it passes, that step is done.
The changelog lists every change of every release, including the small ones that need no guide.
Tip
Stuck? Troubleshooting covers missing styles, images, icons and dates, and failing builds.