Skip to content

Commit eeb4e0b

Browse files
committed
Added 17 specific upgrade steps to v17 tab
1 parent ab1299d commit eeb4e0b

File tree

1 file changed

+38
-22
lines changed
  • umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades

1 file changed

+38
-22
lines changed

umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades/major-upgrades.md

Lines changed: 38 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,44 @@ Delete the `<PackageReference>` entries for these packages.
103103
5. Select the version you are updating to and follow the instructions:
104104

105105
{% tabs %}
106-
{% tab title="Umbraco 15 and above" %}
106+
{% tab title="Umbraco 17" %}
107+
108+
* Update the following packages:
109+
110+
* `Umbraco.Forms.Deploy`
111+
* `Umbraco.Cms`
112+
* `Umbraco.Deploy.Cloud`
113+
* `Umbraco.Deploy.Contrib`
114+
* `Umbraco.Forms`
115+
* `Umbraco.Cloud.Cms`
116+
* `Umbraco.Cloud.StorageProviders.AzureBlob`
117+
118+
* If using Deploy and Forms on Umbraco Cloud:
119+
1. Locate and open the `appsettings.json` file (and any environment-specific variants).
120+
2. Add the following section to `Umbraco:Licenses:Products:<ProductName>`:
121+
122+
```json
123+
{
124+
"Umbraco": {
125+
"Licenses": {
126+
"Products": {
127+
"Umbraco.Deploy": "UMBRACO-CLOUD",
128+
"Umbraco.Forms": "UMBRACO-CLOUD"
129+
}
130+
}
131+
}
132+
}
133+
```
134+
135+
This ensures the built-in Umbraco Cloud licenses are recognized after upgrading. Without these values, you may encounter license validation errors even though your project is on Umbraco Cloud.
136+
137+
* Delete the `Licenses` folder and all `.lic` files within it.
138+
139+
* _[Optional]_ If you use `InMemoryAuto` models builder, or rely on Razor runtime compilation for editing templates via the backoffice, reference the `Umbraco.Cms.DevelopmentMode.Backoffice` package. For more information, see the [Breaking Changes](https://docs.umbraco.com/umbraco-cms/17.latest/fundamentals/setup/upgrading/version-specific#umbraco-17) article.
140+
141+
{% endtab %}
142+
143+
{% tab title="Umbraco 15 and 16" %}
107144
Update the following packages:
108145

109146
* `Umbraco.Forms.Deploy`
@@ -167,27 +204,6 @@ Update the following packages:
167204
Update all projects and packages in your solution to support the latest .NET.
168205
{% endhint %}
169206

170-
6. [Optional] If using Deploy and Forms on Umbraco Cloud:
171-
172-
<details>
173-
174-
<summary>Upgrading to Umbraco 17</summary>
175-
176-
Add the following section to your `appsettings.json` file (and any environment-specific variants):
177-
178-
```json
179-
"Licenses": {
180-
"Products": {
181-
"Umbraco.Deploy": "UMBRACO-CLOUD",
182-
"Umbraco.Forms": "UMBRACO-CLOUD"
183-
}
184-
}
185-
```
186-
187-
This ensures the built-in Umbraco Cloud licenses are recognized after upgrading. Without these values, you may encounter license validation errors even though your project is on Umbraco Cloud.
188-
189-
</details>
190-
191207
## Step 4: Finishing the Upgrade
192208

193209
1. Enable the [Unattended Upgrades](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended) feature.

0 commit comments

Comments
 (0)