Visual Names and Display Names
Visual names are names you assign to a visual when you create it in the Visual Gallery or create it during dashboard creation. This name is used by Composer to track the visual throughout the environment. Display names are a name you can assign to a specific instance of a visual in a dashboard that is shown on the visual.
The field Default Title is now Display Name. Visual Names are no longer editable in the visual information sidebar when you open a specific visual in a dashboard, only in the Visual Gallery.
Once you have saved a visual, the visual name cannot be changed unless you edit the visual using the Visual Gallery. This applies to visuals created in the Visual Gallery, or as part of adding a new visual to a dashboard.
When you change a visual name, this change is reflected throughout the environment in the Visual Name field. See this change in the visual information sidebar.
The visual name is not visible on a visual when displayed in a dashboard, only the display name is shown. View the visual name in the visual information sidebar.
When you add a visual to a dashboard or create a visual in a dashboard, the Display Name for the visual is identical to the Visual Name until you change the Display Name.
Change the Display Name for a visual in a dashboard at any time, using visual information sidebar, or by editing the Display Name on the visual. This only affects this specific instance of the visual in this dashboard, and does not affect the Visual Name field.
Change the Visual Name for a visual in the Visual Gallery at any time. This does not affect the Default Title name for visuals included in existing dashboards.
Visual names must be unique.
If you try to save a visual in the Visual Gallery that has the same name as another visual, an error message appears and your visual is not saved. Rename the new visual to save it.
If you try to save new visual created in a dashboard that has the same name as another visual, the visual is saved with an incremented number in parentheses
(<n>)at the end of the name. For example, a visual named Orders exists in your environment. Subsequent visuals you create and try to save using the same name are saved as Orders (
<n>is an incremental number for each visual using the visual name Orders.
The minimum length of visual names and display names is one character; the maximum length is 255 characters. They can start with and contain numbers, special characters, and uppercase and lowercase characters. They can contain spaces, but cannot start with a space. They cannot be empty or contain only spaces and they cannot have leading or trailing spaces.
The following table describes the behavior for specifying or changing a visual name or display name.
|From the...||Action||Visual Name and Display Name Behavior|
|Visual Gallery||Create a visual|
When you create a visual using the Visual Gallery, but do not assign a name, its visual name is Untitled Visual. The Display Name is also Untitled Visual.
|Edit a visual|
When you edit a visual using the Visual Gallery:
|Dashboard||Create a visual|
When you create a new visual while creating or updating a dashboard, its initial Display Name is the same as the name of the data source used for the visual.
|Edit a visual|
When you edit a visual in a dashboard and change the Display Name, the change only affects that instance of the visual. No other occurrences of the visual on other dashboards are affected.