{"id":20,"date":"2018-11-12T03:07:51","date_gmt":"2018-11-12T11:07:51","guid":{"rendered":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/display-names-enters-preview-for-canvas-apps\/"},"modified":"2025-06-11T08:06:12","modified_gmt":"2025-06-11T15:06:12","slug":"display-names-enters-preview-for-canvas-apps","status":"publish","type":"post","link":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-apps\/display-names-enters-preview-for-canvas-apps\/","title":{"rendered":"Display names enter Preview for Canvas apps"},"content":{"rendered":"

Have you noticed that when you create a custom field in the Common Data Service for Apps that all the fields start with a random prefix like cr5ca_ and spaces are stripped?\u00a0 For example, the name My Custom Field<\/strong> becomes cr5ca_MyCustomField<\/strong> <\/strong>in a Canvas app.<\/p>\n

Have you noticed that spaces and punctuation characters in SharePoint column names become hexadecimal numbers?\u00a0\u00a0 T-shirt Size<\/strong> becomes T_x002d_shirt_x0020_size<\/strong> in a Canvas app.\u00a0 And yet it looks right on the SharePoint site?<\/p>\n

What is going on here is that it\u2019s a good idea to have unique, immutable, concise, no-spaces names for things.\u00a0 These restrictions are common across computer systems helping them to interoperate and are more concise and easier to work with for developers.\u00a0 In CDS these are referred to as logical names<\/strong>.<\/p>\n

While these names may be great for computers and developers, they are less than ideal for the rest of us.\u00a0 Tools for picking items rather than always typing them, such as IntelliSense, help compensate for the longer form.\u00a0 For this reason, both CDS and SharePoint also define display names<\/strong> that are much more human friendly, can contain spaces and punctuation, they don\u2019t need to be unique, and they can change over time.<\/p>\n

A few months ago we introduced an Experimental feature<\/a> to use display names instead of logical names in formulas.\u00a0 I am pleased to announce that this feature is now in Preview and is on by default when creating new apps.\u00a0 You can also turn it on for existing apps in the File menu, App settings, Advanced settings, Use column display names (if it doesn\u2019t take immediate effect, refresh your data sources).\u00a0 It is still listed under Experimental but will be moving up to its rightful place in the Preview section shortly.<\/p>\n

\"image\"<\/a><\/p>\n

Honestly, I find it painful to work with apps anymore that don\u2019t have this feature enabled.\u00a0 But if you have any problems or don\u2019t like it you can easily turn display names off with this same switch.\u00a0 Please be sure to let us know what led you to turn it off in the community forum<\/a>, we\u2019d like to make this feature useful for you.<\/p>\n

A useful fa\u00e7ade<\/h2>\n

With this feature the names of columns are displayed and can be referenced using display names instead of logical names.\u00a0 This only has an impact for data sources that offer display names \u2013 as SQL Server does not have this concept there is no impact for this data source.<\/p>\n

Display names that contain spaces or special characters are enclosed in single quotes, for example \u2018T-shirt Size\u2019<\/strong>.<\/p>\n

Here\u2019s a simple Gallery control connected to the system Accounts entity in CDS.\u00a0 Without display names we see:<\/p>\n

\"2018-11-10_23h59_59\"<\/a><\/p>\n

With display names enabled, the names are much more reasonable and match what is shown in the PowerApps portal\u2019s entity editor:<\/p>\n

\"2018-11-10_23h58_22\"<\/a><\/p>\n

Display names are also supported by IntelliSense in the formula bar.\u00a0\u00a0 Without display names, many of the selections are cryptic and hard to read:<\/p>\n

\"2018-11-11_00h43_42\"<\/a><\/p>\n

With display names, much more human readable:<\/p>\n

\"2018-11-11_00h47_01\"<\/a><\/p>\n

Since display names are not guaranteed to be unique there is the potential for conflict between two columns.\u00a0 If this happens, the logical name of the conflicting column will be shown in parenthesis after the display name.\u00a0 For example, this entity has two columns with Size<\/strong> as the display name, with cr5ca_sizewidth<\/strong> (shown) and cr5ca_sizeheight<\/strong> (not shown) as logical names:<\/p>\n

\"image\"<\/a><\/p>\n

Keeping all the nombres straight<\/h2>\n

Behind the scenes we always keep the logical names.\u00a0 <\/strong>Have no fear, we never lose track of these important names.\u00a0 These are the names that uniquely identify the column and that we must use when communicating with the data service.\u00a0 <\/p>\n

Logical names also help us keep things straight when display names change (they can and do).\u00a0 An important variant of which is authors using different languages.\u00a0 CDS has localized display names in many languages for the system entities. <\/p>\n

For example, here is that app from above as viewed by a Spanish author:<\/p>\n

\"2018-11-11_00h04_01\"<\/a><\/p>\n

And as viewed by an author in Japan:<\/p>\n

\"2018-11-11_00h02_15\"<\/a><\/p>\n

Note that ThisItem <\/strong>is not changing between languages.\u00a0 Most of the formula language is not localized, only the names of columns will change and the punctuation for decimal numbers, argument separators, and chaining operator<\/a>.<\/p>\n

And I have a secret: you can still use the logical name.\u00a0 We won\u2019t advertise these names in IntelliSense, you\u2019ll need to know what they are.\u00a0 For example, watch what happens up until I type the y<\/strong> in city<\/strong> \u2013 no IntelliSense.\u00a0 But once a
\nvalid logical name has been entered, the formula is no longer in an error state and the proper value is returned.\u00a0 We don\u2019t advertise in IntelliSense since that would duplicate the names and make a mess, the experience we want is the one when I select \u2018Address 1: City\u2019\u00a0 without needing to type it.\u00a0 Note that we may replace the logical name with the display name when the app is reloaded, especially if you change languages.<\/p>\n

\"2018-11-11_02h10_37\"<\/a><\/p>\n

Studio coverage<\/h2>\n

One of the reasons this feature has been Experimental so long is that we wanted to cover most places in the Studio where names are displayed.\u00a0 Turns out there are a lot of them.\u00a0 We got most of them but there are still some places where we may drop to logical names:<\/p>\n