Upgrading (18): Upgrade to 17 before 18, which can't upgrade from versions older than 16.4 - #8585
Conversation
…sions older than 16.4 Umbraco 18 removed the migrations from 13 to 17 (umbraco/Umbraco-CMS#22618), but the 18 docs still described a direct upgrade from 13. Route 13 upgrades through 17, add a 17 to 18 step, note that 18 doesn't include the content migration to 15, and use a migration state from the 18 plan in the downgrade example. Point the Engage link to the 13 section at the 17 docs. Part of #8580. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
iOvergaard
added
category/umbraco-cms
ai-generated
|
Thanks for opening this PR! 🎉 Quick question: Does this PR include any AI-generated content? AI tools are absolutely welcome here! We only ask that you follow our AI contribution guidelines to help keep the documentation consistent and trustworthy. Drop a quick comment to let us know! |
There was a problem hiding this comment.
Copilot review overview
🟢 Approval recommended
The focused documentation changes match the verified CMS references, with no unresolved findings.
Review effort: Balanced
Findings: None
What changed in this PR
Corrects the Umbraco 18 upgrade guidance to route Umbraco 13 projects through Umbraco 17, reflecting the 16.4 minimum upgrade version.
Changes:
- Documents the 13 → 17 → 18 upgrade path.
- Updates migration guidance, source links, and the migration-state example.
- Points Engage guidance to the version-specific CMS documentation.
| File | Description |
|---|---|
18/umbraco-cms/get-started/upgrading-and-migrating/version-specific.md |
Adds Umbraco 17 upgrade preparation. |
18/umbraco-cms/get-started/upgrading-and-migrating/upgrade-details.md |
Corrects the upgrade example and minimum version. |
18/umbraco-cms/get-started/upgrading-and-migrating/find-your-upgrade-path/README.md |
Separates the 13-to-17 and 17-to-18 steps. |
18/umbraco-cms/get-started/upgrading-and-migrating/find-your-upgrade-path/migrate-content-to-umbraco-15.md |
Clarifies migration availability and pins source links. |
18/umbraco-cms/get-started/upgrading-and-migrating/downgrades-and-rerunning-migrations.md |
Updates the migration-state example for Umbraco 18. |
17/umbraco-engage/upgrading/migrate-from-umarketingsuite.md |
Targets the Umbraco 17 upgrade documentation. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
sofietoft
left a comment
sofietoft
left a comment
There was a problem hiding this comment.
Thanks @iOvergaard !
I've added a couple of suggestions.
Apply the suggested wording from review. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Jacob Overgaard <752371+iOvergaard@users.noreply.github.com>
|
The Link Checker found broken links in your PR. Broken links found in: 18/umbraco-cms/get-started/upgrading-and-migrating/find-your-upgrade-path/README.md 🔀 Redirect → [522] http://issues.umbraco.org/issue/U4-6595 (at 485:108) | Rejected status code: 522 Unknown status code | Followed 1 redirect. Redirects: http://issues.umbraco.org/issue/U4-6595 --[301]--> https://issues.umbraco.org/issue/U4-6595 🔀 Redirect → [522] http://issues.umbraco.org/issue/U4-8031 (at 559:97) | Rejected status code: 522 Unknown status code | Followed 1 redirect. Redirects: http://issues.umbraco.org/issue/U4-8031 --[301]--> https://issues.umbraco.org/issue/U4-8031 🔀 Redirect → [522] http://issues.umbraco.org/issues/U4?q=Due+in+version%3A+7.6.0+Backwards+compatible%3F%3A+No+ (at 413:51) | Rejected status code: 522 Unknown status code | Followed 1 redirect. Redirects: http://issues.umbraco.org/issues/U4?q=Due+in+version%3A+7.6.0+Backwards+compatible%3F%3A+No+ --[301]--> https://issues.umbraco.org/issues/U4?q=Due+in+version%3A+7.6.0+Backwards+compatible%3F%3A+No+ ⚠ Unknown error → [403] https://jumoo.co.uk/usync/ (at 103:40) |#124; Rejected status code: 403 Forbidden |
📋 Description
The 18 docs describe a direct upgrade from Umbraco 13, but Umbraco 18 can only upgrade from 16.4 or later: umbraco/Umbraco-CMS#22618 removed the migrations from 13 to 17. This PR routes 13 upgrades through 17, the latest LTS, in
18/:release-17.7.0instead ofmain, where the files no longer exist.This PR is AI-generated with Claude Code, following the AI contribution guidelines. The claims are checked against the CMS source:
UmbracoPlanonmain(InitialStateVersion = new(16, 4, 0), and{3A1A8047-74AE-491A-B2C4-0BAE4A1289EC}as the last 17 state), and theV_15_0_0files atrelease-17.7.0.📎 Related Issues (if applicable)
Part of #8580. The broken links and the rest of the section follow separately.
✅ Contributor Checklist
I've followed the Umbraco Documentation Style Guide and can confirm that:
Product & Version (if relevant)
Umbraco CMS 18, plus one link in the Umbraco Engage 17 docs.
Deadline (if relevant)
None, though Umbraco 13 reaches end of life on 14-12-2026, and 18.latest is the default docs version.
📚 Helpful Resources