Create a page in UI Builder

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read

    • Create a page in UI Builder for a portal, workspace, or custom application so that you can build a web experience for your users.

    Before you begin

    Role required: ui_builder_admin

    About this task

    A page has a collection of components that make up a workspace, portal, or custom application user interface (UI).

    Figure 1. UI Builder
    UI Builder screen.

    Procedure

    1. Navigate to All > Now Experience Framework > UI Builder.
    2. Open an experience to work in or create an experience by selecting Create > Experience.
      See Configure how users interact with your applications in UI Builder for more information on creating experiences.
    3. Select the + icon in the Pages and variants section.
      Create page button on the experience view page.
    4. Select Create a new page.
      Page type selection modal.
    5. Select Create from scratch instead.
      Template selection screen with arrow pointing to Create from scratch instead button.

      You can also create pages using page templates, see Create a page from a template for more information.

    6. Enter a unique name for the page in the Name field.
    7. Specify a path for your page in the URL Path field. UI Builder generates a default path based on the name that you provided in the previous step.
      A default path is added based on your page name. You can also create your own path. The path is required and must be unique. The path can include digits (0-9), letters (A-Z, a-z), and a few special characters ("-", ".", "_", "~"), with the words separated by a forward slash or hyphen. The URL preview shows the path of your page.
      Page details screen with name and URL path fields.
      Note:
      The application scope defaults to the scope that the user is currently in within the ServiceNow AI Platform®. For more information about the application scope, see Learn about security and roles.
    8. Select Continue.
    9. Optional: Add required parameters to your page URL.
      1. Click + Add.
      2. Enter the required parameters for your page.
        A required parameter is a piece of data that your page requires, such as a sys_id, table, or query. Required parameters are useful for components, because they can bind to the value of the required parameter.
        Required parameters in UI Builder.
        For more information, see Manage UI Builder pages and page variants.
    10. Optional: Add optional parameters to the URL of your page.
      1. Click + Add.
      2. Enter the optional parameters for your page.
        Unlike required parameters, optional parameters are always name and value pairs that work no matter what order that they are provided in.
        Optional parameters in UI Builder.
        For more information, see Manage UI Builder pages and page variants.
    11. Select Looks good.
    12. Enter a name for the page variant.
      The form automatically adds Default to the page name.
    13. Add one or more audiences for this page.
      If an audience you need is not listed, you can choose the Open audiences in platform link to create one.
    14. Optional: Add conditions for when to display the page or tab by entering an encoded query string.
    15. Select Create to create your blank page.
      The page you created displays in the Page and variants section of your experience.
      Note:
      The new variant is stored in the UX Screen [sys_ux_screen] table.
    16. Select Editor to start adding components to your page. For more information, see Customize UI Builder pages using components.