---
schema_version: "1"
id: 62d94c029c314930b20d4e05df08681e627f15ada0e89e8dd1512de56f5e15d1
title: Edit ui.json
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/bi_dev_guide_wave_templates/guides/concept/bi-templatesdev-edit-ui-json.md
canonical_url: https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/guide/bi-templatesdev-edit-ui-json.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: f97e5f7bb095fa4cb34c43bfc67651b487b5298bd18da6cb5747534f29d52be4
products:
  - Analytics Templates Developer Guide
  - analytics
---

# Edit ui.json

The `ui.json` file determines how your template displays the configuration wizard questions defined in `variables.json`.

**note:** This file isn’t used in an embedded app. Templates with a `templateType` of `embeddedapp` aren’t visible in CRM Analytics Studio for install.

The UI file determines wizard page layout, defining the order in which variables described in `variables.json` appear on a page.

```nolang
{

"ui" :{

  "pages": [
    {
      "title":"Customization Questions",
      "variables":[

        { "name": "customizeUserObjectInfo" }

      ]
    }
,
    {

      "title":"User Object Information",
      // Only show this page if the user checked the "customizeUserObjectInfo" checkbox.

      "condition":"{{Variables.customizeUserObjectInfo == 'Yes'}}",

      "variables":[

        { "name": "userObjectUsernameField" },

        { "name": "userObjectName" },
        { "name": "pageConditionVariable" },

        { "name": "showBoolean" }
      ],
      "helpUrl":"https://salesforce.com/wave/salesapp/page1/help.html"

    },

    {

      "title":"Job Information",

      "variables":[

        { "name": "maxAllowedOffset" },
        { "name": "booleanExample", "visibility": "{{Variables.showBoolean ? 'Visible' : 'Hidden'}}" },
      ],
      "helpUrl":"https://salesforce.com/wave/salesapp/page2/help.html"

    }

  ],
  "displayMessages": [
    {
      "text":"When we're done creating the app, we'll send you an email.",
      "location": "AppLandingPage"
    }
  ]

}
```

The displayMessages text is visible to the user on the page that displays the app creation progress.

![The app landing page showing the app creation progress and the custom displayMessages text.](https://developer.salesforce.com/media/bi_dev_guide_wave_templates/bi_templated_app_displayMessage.png)

- **[Page Condition Syntax for ui.json](https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/reference/bi-templatesdev-page-cond-syntax-ui-json.md)**


    You can make a page's appearance conditional on the value of a variable. For example, if the user answers "No" when asked if there is a Products dimension, you can use a conditional to ensure that no Products-related page displays in the wizard. Adding page conditions enables wizard page flow. If the condition is met, then the page with the condition will display; if the condition is not met, the page will not display. Use the following syntax to instruct which conditionals control the display of pages.

- **[Variables Array in ui.json](https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/reference/bi-templatesdev-vars-array-ui-json.md)**


    Use a `variables` array to display a question to users conditionally. You can optionally display a question as disabled in the case where an answer has been found or computed using Apex Class. To accommodate variable condition and other fields, the `variables` array must be an array of objects instead of an array of variable names.

- **[Use VisualForce To Customize the Wizard UI](https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/guide/bi-templatesdev-creating-custom-wizard-vf.md)**


    To customize wizard appearance beyond the default interface, use VisualForce and a JavaScript library.

**See Also**

- [ui.json Attributes](https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/reference/bi-templatesdev-ui-json-attributes.md)