Skip to content

Commit 1442de8

Browse files
committed
Clarified documentation on the AllowEditInvariantFromNonDefault setting
1 parent d910687 commit 1442de8

File tree

9 files changed

+15
-53
lines changed

9 files changed

+15
-53
lines changed

10/umbraco-cms/reference/configuration/contentsettings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The following snippet will give an overview of the keys and values in the conten
1313
"KeepAllVersionsNewerThanDays": 7,
1414
"KeepLatestVersionPerDayForDays": 90
1515
},
16-
"AllowEditInvariantFromNonDefault": true,
16+
"AllowEditInvariantFromNonDefault": false,
1717
"AllowedUploadFiles": [],
1818
"AllowedMediaHosts": [],
1919
"DisableDeleteWhenReferenced": false,
@@ -60,9 +60,9 @@ In the root level section, that is those without a seperate sub section like Ima
6060

6161
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
6262

63-
When the setting is set to `false` the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
63+
When the setting is set to `false` (default) the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
6464

65-
When set to `true` (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
65+
When set to `true` the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
6666

6767
### Allowed upload files
6868

13/umbraco-cms/fundamentals/backoffice/variants.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,8 +66,6 @@ Each Property Editor that does not allow variants (an Invariant Property) will b
6666
{% hint style="info" %}
6767
Whether or not the lock is enabled on the invariant properties depends on the `AllowEditInvariantFromNonDefault` setting in the `appsettings.json` file.
6868

69-
For projects created on Umbraco version 10.2 or later, the setting is `true`, by default. If the project is upgraded to version 10.2 or later, the setting will by default be `false`.
70-
7169
Learn more about the `AllowEditInvariantFromNonDefault` setting in the [Security Settings](../../reference/configuration/securitysettings.md) article.
7270
{% endhint %}
7371

13/umbraco-cms/reference/configuration/contentsettings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The following snippet will give an overview of the keys and values in the conten
1717
"KeepAllVersionsNewerThanDays": 7,
1818
"KeepLatestVersionPerDayForDays": 90
1919
},
20-
"AllowEditInvariantFromNonDefault": true,
20+
"AllowEditInvariantFromNonDefault": false,
2121
"AllowedMediaHosts": [],
2222
"AllowedUploadedFileExtensions": [],
2323
"DisableDeleteWhenReferenced": false,
@@ -62,9 +62,9 @@ In the root level section, that is those without a separate sub section like Ima
6262

6363
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
6464

65-
When the setting is set to `false` the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
65+
When the setting is set to `false` (default) the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
6666

67-
When set to `true` (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
67+
When set to `true` the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
6868

6969
### Allowed upload file extensions
7070

14/umbraco-cms/fundamentals/backoffice/variants.md

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,6 @@ When you return to your content node you will notice two things:
5959

6060
![Allowing Variance on properties](images/Allowing-Variance-on-properties.png)
6161

62-
Each Property Editor that does not allow variants (an Invariant Property) will by default need to be unlocked in order to be edited. The lock exists to make it clear that this change will affect more languages. Since the value of the invariant properties are shared between all variants on the website.
63-
64-
![How an invariant property looks when it is locked](../../../../10/umbraco-cms/fundamentals/backoffice/images/invariant-property-locked.png)
65-
66-
{% hint style="info" %}
67-
Whether or not the lock is enabled on the invariant properties depends on the `AllowEditInvariantFromNonDefault` setting in the `appsettings.json` file.
68-
69-
For projects created on Umbraco version 10.2 or later, the setting is `true`, by default. If the project is upgraded to version 10.2 or later, the setting will by default be `false`.
70-
71-
Learn more about the `AllowEditInvariantFromNonDefault` setting in the [Security Settings](../../reference/configuration/securitysettings.md) article.
72-
{% endhint %}
73-
7462
To read about how you render variant content in Templates, check out the [rendering content section](../design/rendering-content.md).
7563

7664
## Test your language variants

14/umbraco-cms/reference/configuration/contentsettings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The following snippet will give an overview of the keys and values in the conten
1717
"KeepAllVersionsNewerThanDays": 7,
1818
"KeepLatestVersionPerDayForDays": 90
1919
},
20-
"AllowEditInvariantFromNonDefault": true,
20+
"AllowEditInvariantFromNonDefault": false,
2121
"AllowedMediaHosts": [],
2222
"AllowedUploadedFileExtensions": [],
2323
"DisableDeleteWhenReferenced": false,
@@ -61,9 +61,9 @@ In the root level section, that is those without a separate sub section like Ima
6161

6262
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
6363

64-
When the setting is set to `false` the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
64+
When the setting is set to `false` (default) the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
6565

66-
When set to `true` (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
66+
When set to `true` the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
6767

6868
### Allowed upload file extensions
6969

15/umbraco-cms/fundamentals/backoffice/variants.md

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,6 @@ When you return to your content node you will notice two things:
5959

6060
![Allowing Variance on properties](images/Allowing-Variance-on-properties.png)
6161

62-
Each Property Editor that does not allow variants (an Invariant Property) will by default need to be unlocked in order to be edited. The lock exists to make it clear that this change will affect more languages. Since the value of the invariant properties are shared between all variants on the website.
63-
64-
![How an invariant property looks when it is locked](../../../../10/umbraco-cms/fundamentals/backoffice/images/invariant-property-locked.png)
65-
66-
{% hint style="info" %}
67-
Whether or not the lock is enabled on the invariant properties depends on the `AllowEditInvariantFromNonDefault` setting in the `appsettings.json` file.
68-
69-
For projects created on Umbraco version 10.2 or later, the setting is `true`, by default. If the project is upgraded to version 10.2 or later, the setting will by default be `false`.
70-
71-
Learn more about the `AllowEditInvariantFromNonDefault` setting in the [Security Settings](../../reference/configuration/securitysettings.md) article.
72-
{% endhint %}
73-
7462
To read about how you render variant content in Templates, check out the [rendering content section](../design/rendering-content.md).
7563

7664
## Test your language variants

15/umbraco-cms/reference/configuration/contentsettings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The following snippet will give an overview of the keys and values in the conten
1717
"KeepAllVersionsNewerThanDays": 7,
1818
"KeepLatestVersionPerDayForDays": 90
1919
},
20-
"AllowEditInvariantFromNonDefault": true,
20+
"AllowEditInvariantFromNonDefault": false,
2121
"AllowedMediaHosts": [],
2222
"AllowedUploadedFileExtensions": [],
2323
"DisableDeleteWhenReferenced": false,
@@ -63,9 +63,9 @@ In the root level section, that is those without a separate sub section like Ima
6363

6464
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
6565

66-
When the setting is set to `false` the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
66+
When the `AllowEditInvariantFromNonDefault` setting is set to `false` (default) the invariant properties can only be edited and published from the default language. This means you need access to the default language in order to edit the property. You will also need to publish the default language to see changes in the invariant property on your website.
6767

68-
When set to `true` (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
68+
When set to `true` the invariant properties can be edited and published from any language.
6969

7070
### Allowed upload file extensions
7171

16/umbraco-cms/fundamentals/backoffice/variants.md

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,6 @@ When you return to your content node you will notice two things:
5959

6060
![Allowing Variance on properties](images/Allowing-Variance-on-properties.png)
6161

62-
Each Property Editor that does not allow variants (an Invariant Property) will by default need to be unlocked in order to be edited. The lock exists to make it clear that this change will affect more languages. Since the value of the invariant properties are shared between all variants on the website.
63-
64-
![How an invariant property looks when it is locked](../../../../10/umbraco-cms/fundamentals/backoffice/images/invariant-property-locked.png)
65-
66-
{% hint style="info" %}
67-
Whether or not the lock is enabled on the invariant properties depends on the `AllowEditInvariantFromNonDefault` setting in the `appsettings.json` file.
68-
69-
For projects created on Umbraco version 10.2 or later, the setting is `true`, by default. If the project is upgraded to version 10.2 or later, the setting will by default be `false`.
70-
71-
Learn more about the `AllowEditInvariantFromNonDefault` setting in the [Security Settings](../../reference/configuration/securitysettings.md) article.
72-
{% endhint %}
73-
7462
To read about how you render variant content in Templates, check out the [rendering content section](../design/rendering-content.md).
7563

7664
## Test your language variants

16/umbraco-cms/reference/configuration/contentsettings.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The following snippet will give an overview of the keys and values in the conten
1717
"KeepAllVersionsNewerThanDays": 7,
1818
"KeepLatestVersionPerDayForDays": 90
1919
},
20-
"AllowEditInvariantFromNonDefault": true,
20+
"AllowEditInvariantFromNonDefault": false,
2121
"AllowedMediaHosts": [],
2222
"AllowedUploadedFileExtensions": [],
2323
"DisableDeleteWhenReferenced": false,
@@ -63,9 +63,9 @@ In the root level section, that is those without a separate sub section like Ima
6363

6464
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
6565

66-
When the setting is set to `false` the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
66+
When the `AllowEditInvariantFromNonDefault` setting is set to `false` (default) the invariant properties can only be edited and published from the default language. This means you need access to the default language in order to edit the property. You will also need to publish the default language to see changes in the invariant property on your website.
6767

68-
When set to `true` (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
68+
When set to `true` the invariant properties can be edited and published from any language.
6969

7070
### Allowed upload file extensions
7171

0 commit comments

Comments
 (0)