You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades/major-upgrades.md
+38-22Lines changed: 38 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -103,7 +103,44 @@ Delete the `<PackageReference>` entries for these packages.
103
103
5. Select the version you are updating to and follow the instructions:
104
104
105
105
{% 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" %}
107
144
Update the following packages:
108
145
109
146
*`Umbraco.Forms.Deploy`
@@ -167,27 +204,6 @@ Update the following packages:
167
204
Update all projects and packages in your solution to support the latest .NET.
168
205
{% endhint %}
169
206
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
-
191
207
## Step 4: Finishing the Upgrade
192
208
193
209
1. Enable the [Unattended Upgrades](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended) feature.
0 commit comments