From 80429f8e998c4ade5c5a51684b871e2c60dfccdf Mon Sep 17 00:00:00 2001 From: Alisa Frelia <1579593+exec-astraea@users.noreply.github.com> Date: Fri, 30 Jan 2026 14:04:20 +0100 Subject: [PATCH 1/2] Added documentation for the new string behavior toggle and mentioned the toggle in the upgrade guide. --- .../installation/upgrading-from-10-to-11/_index.md | 6 +++++- .../modeling/app-explorer/app/app-settings/_index.md | 9 +++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md b/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md index 73e86d0bf13..e09e796cebe 100644 --- a/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md +++ b/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md @@ -105,7 +105,11 @@ In Mendix 11.0.0, we have made this behavior consistent. Now, strings are handle We understand that this change might cause unexpected changes in existing applications migrated from older versions of Mendix. -We recommend carefully analyzing all expressions that are comparing strings against `''` or `empty` and doing extensive testing after the migration. +In Mendix 11.6.3 we have introduced [an option](https://docs.mendix.com/refguide/app-settings/#new-string-behavior) to toggle between the old and the new client-side String attribute behaviors. Projects migrating from Mendix 10 to 11 will retain the old String behavior unless you manually switch to the new one. + +We recommend to migrate your pre-existing projects to use the new behavior as soon as possible. The new behavior will improve consistency between nanoflows and microflows, which will lead to less bugs in your applications. + +Please make sure to carefully analyze all expressions that are comparing strings against `''` or `empty` and do extensive testing after the migration. #### Example 1 diff --git a/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md b/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md index df4b971fac6..f1e7b3a8ba6 100644 --- a/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md +++ b/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md @@ -40,6 +40,15 @@ The available configuration options are as follows: * **Yes**: Use the React client (default). In this mode, you will get consistency errors for incompatible widgets. * **Migration mode**: Use the React client and ignore incompatible widgets. Placeholders are displayed in the case of incompatible widgets. Recommended when trying out the new client. +### Use new string behavior {#new-string-behavior} + +Introduced in Mendix 11.6.3. + +If this option is enabled, Web (both React and Dojo) and Native Mobile clients will be able to handle both `empty` and empty string `''` values for `String` attributes. +If this options is disabled, `String` attribute values on the client-side will always contain only the `''` value to represent empty state. `empty` values will be automatically converted to `''` when transfered to the client-side. + +You can read detailed explanation in the [upgrade guide](https://docs.mendix.com/refguide/upgrading-from-10-to-11/#empty-strings-handling). + ### Static Resources from Disk If this option is enabled, the static resources for your mobile application are downloaded as soon as you open your application rather than bit by bit as you navigate through the app. This can drastically cut down the number of network requests, as the files can be retrieved from the disk rather than from the server. From f7860d53ad90b264caa17206bad1d6334c364ed4 Mon Sep 17 00:00:00 2001 From: quinntracy Date: Mon, 9 Feb 2026 14:40:04 +0100 Subject: [PATCH 2/2] Review --- .../installation/upgrading-from-10-to-11/_index.md | 10 +++++++--- .../modeling/app-explorer/app/app-settings/_index.md | 11 +++++++---- 2 files changed, 14 insertions(+), 7 deletions(-) diff --git a/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md b/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md index e09e796cebe..585b8583c6c 100644 --- a/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md +++ b/content/en/docs/refguide/installation/upgrading-from-10-to-11/_index.md @@ -101,15 +101,19 @@ In a Microflow, this distinction exists and the expression would yield `false`. Moreover, on the client side a String attribute with a value set to `empty` would be treated as if it contains `''`. This made it impossible to check in a Nanoflow whether an attribute is `empty` or if it has an empty String value `''`. +#### Mendix 11.0.0 + In Mendix 11.0.0, we have made this behavior consistent. Now, strings are handled in the same way no matter where you use them. We understand that this change might cause unexpected changes in existing applications migrated from older versions of Mendix. -In Mendix 11.6.3 we have introduced [an option](https://docs.mendix.com/refguide/app-settings/#new-string-behavior) to toggle between the old and the new client-side String attribute behaviors. Projects migrating from Mendix 10 to 11 will retain the old String behavior unless you manually switch to the new one. +#### Mendix 11.6.3 + +In Mendix 11.6.3, we introduced [an option](https://docs.mendix.com/refguide/app-settings/#new-string-behavior) to toggle between the old and the new client-side String attribute behaviors. Projects migrating from Mendix 10 to 11 will retain the old String behavior unless you manually switch to the new one. -We recommend to migrate your pre-existing projects to use the new behavior as soon as possible. The new behavior will improve consistency between nanoflows and microflows, which will lead to less bugs in your applications. +It is recommended to migrate your pre-existing projects to use the new behavior as soon as possible. The new behavior will improve consistency between nanoflows and microflows, which will lead to fewer bugs in your applications. -Please make sure to carefully analyze all expressions that are comparing strings against `''` or `empty` and do extensive testing after the migration. +Make sure to carefully analyze all expressions that are comparing strings against `''` or `empty` and do extensive testing after the migration. #### Example 1 diff --git a/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md b/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md index f1e7b3a8ba6..748237df847 100644 --- a/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md +++ b/content/en/docs/refguide/modeling/app-explorer/app/app-settings/_index.md @@ -40,14 +40,17 @@ The available configuration options are as follows: * **Yes**: Use the React client (default). In this mode, you will get consistency errors for incompatible widgets. * **Migration mode**: Use the React client and ignore incompatible widgets. Placeholders are displayed in the case of incompatible widgets. Recommended when trying out the new client. -### Use new string behavior {#new-string-behavior} +### Use New String Behavior {#new-string-behavior} -Introduced in Mendix 11.6.3. +{{% alert type="info" %}} +This setting was introduced in Mendix 11.6.3. +{{% /alert %}} + +If this option is enabled, Web (both React and Dojo) and Native Mobile clients will be able to handle both `empty` and empty string `''` values for `String` attributes.
-If this option is enabled, Web (both React and Dojo) and Native Mobile clients will be able to handle both `empty` and empty string `''` values for `String` attributes. If this options is disabled, `String` attribute values on the client-side will always contain only the `''` value to represent empty state. `empty` values will be automatically converted to `''` when transfered to the client-side. -You can read detailed explanation in the [upgrade guide](https://docs.mendix.com/refguide/upgrading-from-10-to-11/#empty-strings-handling). +For a detailed explanation, see the *Empty Strings Handling* section of [Upgrading from Mendix Studio Pro 10 to 11](/refguide/upgrading-from-10-to-11/#empty-strings-handling). ### Static Resources from Disk