---
alias: tutorials-howto-create-workspace
description: "Create a Workspace UI Page with a Resource Grid template and make it Effective in MES."
---

# How to: Create a Workspace

### 1. Go to the Administration menu.

![Screenshot showing UI Pages in the Administration menu.](images/howto_workspace01.png)

### 2. Open UI Pages.

![Screenshot showing UI Pages in the Administration menu.](images/howto_workspace02.png)

### 3. Select the New button.

![Screenshot showing the New action on the UI Pages page.](images/howto_workspace03.png)

### 4. Select a Change Set.

Choose an existing **Change Set** or create a new one. Select **Next** to continue.

![Screenshot showing the Change Set selection in the UI Page creation wizard.](images/howto_workspace04.png)

### 5. Enter the UI Page information.

On **General Data**:

* Enter a unique **Name**.
* Set **UI Type** to **Page**.
* Set **Scope** to **Workspace**.
* Choose the **Layout** for the intended display.

![Screenshot showing the UI Page General Data with Page type and Workspace scope.](images/howto_workspace05.png)

The **Workspace** scope supplies the **Workgroup** and **User** context properties used by the widget templates.

### 6. Create the UI Page.

Select **Create** to save the new UI Page and open its builder.

![Screenshot showing the new Workspace UI Page open in the builder.](images/howto_workspace06.png)

### 7. Add a Grid widget.

In the **Widgets** panel of the builder, open **Interaction**. Drag the **Grid** onto the empty canvas.

!!! note
    This example uses a Grid widget. [[user-guide-uipage-widgets-filter]] and [[user-guide-uipage-widgets-filter-tabs]] widgets also provide templates for UI Pages with Workspace scope. These templates configure filters or views for the selected Workgroup.

![Screenshot showing a Grid widget placed on the Workspace canvas.](images/howto_workspace07.png)

### 8. Open the Grid settings.

![Screenshot showing the option to open the settings of the Grid widget.](images/howto_workspace08.png)

### 9. Select the Columns tab.

Select :iot-synchronize-lg: and choose, for example, **Resource** from the templates.

![Screenshot showing the Resource template option for the Grid columns.](images/howto_workspace09.png)

Review the generated columns, data source, and links. Keep the template connections that supply the **Workgroup** context and the **Grid** data.

=== "Columns"

    ![Screenshot showing the Resource template applied to the Grid widget in the Columns tab.](images/howto_workspace10.png)

=== "Links"

    ![Screenshot showing the Resource template applied to the Grid widget in the Links tab.](images/howto_workspace11.png)

!!! info
    For the generated configuration and other templates, see [[user-guide-uipage-widgets-grid#using-templates|Grid Templates]].

### 10. Save the Grid and UI Page.

Select **Save and Close** in the **Grid** settings.

![Screenshot showing the Save and Close option in the Grid Widget Settings wizard.](images/howto_workspace12.png)

Then select **Save** in the UI Page builder to save the page configuration.

![Screenshot showing the Save option in the UI Page builder.](images/howto_workspace13.png)

### 11. Request approval and make the UI Page Effective.

Complete the **Change Set** approval process with the authorized approver. If the **Change Set** does not make its items Effective on approval, set the approved **UI Page** version Effective.

![Screenshot showing the approved Workspace UI Page in the Effective state.](images/howto_workspace14.png)

!!! info
    For approval and effectiveness, see [[tutorials-howto-seteffectiveaversionedentity]].

The **Workspace** is now Effective and ready for access configuration.

!!! info
    To configure and verify access, see [[tutorials-howto-give-user-workspace-access]].