---
alias: user-guide-uipages-create-uipage
description: "Create UI pages by defining name, type, layout, and scope within the system administration interface"
---

# Create UI Page

:lock: UIPage.**Create**

By accessing the **UI Pages** in **Administration**, the system displays the available **UI Pages**.

To create a **UI Page** you need to select **New** on the top ribbon and complete the information as described below.

## Sequence of Steps

{% include-markdown 'includes/pages/info_creating_versioned_entities.md' %}

### Step 1: Change Set

{% include-markdown 'includes/pages/step_one_versioned_entities.md' %}

![Create UI Page with a change set.](images/uipage_create1.png)

### Step 2: General Data

1. Enter the **UI Page** name.
2. Optionally, enter the **Revision**.
3. Optionally, enter the **Description**.
4. Select the **UI Type**:

    * **Cluster** - a special type of page that organizes a navigation menu on the left and an information panel on the right, useful for elements with multiple layers of information.
    * **Page** - an organized set of elements that allow you to interact with the system.
    * **Step** - a specific step to be used in UI Pages of type Wizard.
    * **Wizard** - a set of steps that prepares data to call a system action.

    !!! info
        For more information on UI Types Step and Wizard, see [[user-guide-uipages-design#creating-steps-and-wizards|Creating Steps and Wizards]].

5. The **Folder** is set to `\Dashboards` by default.
6. Select the **Scope** accordingly.

    * **Entity Type** - use this scope for pages that you want to associate with an Entity Type. For more information, see [[user-guide-uipages-entity-type]].
    * **General** - use this scope for general purpose pages. For more information, see [[user-guide-uipages-general]].
    * **Menu Entry** - use this scope for pages that you want to associate with a Menu Entry. For more information, see [[user-guide-uipages-menu-entry]].
    * **Workspace** - use this scope for pages that you want to associate with a Workspace. For more information, see [[user-guide-uipages-workspaces]].

    !!! info

        * To understand where you can access the created page according to the selected scope, see [[user-guide-uipages-create-uipage#scopes|Scopes]].
        * Add properties to a UI Page in the Properties tab of the Page Builder settings wizard. For more information, see [[user-guide-uipages-design#properties]].

7. Optionally, select the **Layout**:

    * **Desktop (1536 x 864)**
    * **Desktop (1920 x 1080)**
    * **Laptop (1280 x 720)**
    * **Laptop (1366 x 768)**
    * **Phone (360 x 800)**
    * **Phone (390 x 844)**
    * **Phone (414 x 896)**
    * **Tablet (1280 x 800)**
    * **Tablet (768 x 1024)**

    !!! info
        You can customize the default values for the Layouts or add new ones by editing the fields in the [[uipagelayouts-gt]] Generic Table.

8. Optionally, enter a comment.
9. Select **Create**.

![Screenshot showing a user interface page creation wizard with options for selecting data.](images/uipage_create2.png)

!!! note
    You can only use a UI Page with Universal State set to `Effective`. Approve the Change Set before using any UI Page.

## After Creation

After successfully creating the **UI Page**, start designing your new **UI Page**. Drag and drop the widgets from the widget panel on the left into the desired areas. For more information, see [[user-guide-uipages-design]].

{% include-markdown 'includes/pages/ai_uipage_generation.md' %}

![Screenshot showing a UI page creation interface with widgets on the left side and empty areas for dragging and dropping.](images/uipage_create6.png)

Optionally, select **Settings** on the top bar to define the **UI Page** settings. For more information, see [[user-guide-uipages-design#page-builder-settings|Page Builder Settings]].

![Screenshot showing a page with various settings options, including Definition, Layouts, Properties, Action Buttons, Tasks, and more.](images/uipage_settings_wizard.png)

After finishing the design of the **UI Page**, request its approval to start using it.

After exiting the Edit mode, you can access the following buttons on the top ribbon:

* New: Revision, Version.
* Refresh.
* Edit.
* Lock.
* More:
    * General: Clone, Terminate, Change Change Set, Mark Revision Obsolete, Export.
    * Settings: Save, Reset.
    * UI Page: New.
    * Show Inactive Actions (show/hide action).

![uipage_create5](images/uipage_create5.png)