Upgrading Igloo
Igloo versions track Umbraco's major releases, and there is no upgrade path that skips a major version. You move up one major version at a time, rebuilding your content for the new editor as you go.
Versions prior to v17 have no official upgrade path. Moving between major versions has always meant rebuilding your content by hand for the new editor. v17 is where that changes. Built on Umbraco's Block Grid and the new theme system, it gives Igloo a stable foundation, so upgrades from v17 onwards are designed to be supported and far smoother. It's one of the biggest reasons to move to v17.
Upgrade path
| From | To | Where it's documented |
|---|---|---|
| Igloo v5 (Umbraco 8) | Igloo v13 (Umbraco 13) | v13 documentation |
| Igloo v13 (Umbraco 13) | Igloo v17 (Umbraco 17) | Umbraco Upgrade v13 -> v17 |
If you're on Igloo v5 or v6, upgrade to v13 first using the v13 documentation (switch versions with the dropdown in the top navigation), then come back here for the v13 -> v17 step.
Upgrading from Igloo v13
The v13 to v17 move is the upgrade most sites are making now. There's no automated path: v17 rebuilds the page editor on Umbraco's Block Grid, so widgets have to be re-created. Use these two pages together:
- Umbraco Upgrade v13 -> v17 — the upgrade steps, re-adding your licence, and what to migrate.
- Widget Mapping v13 -> v17 — the v13 -> v17 widget equivalents for rebuilding each page.