---
alias: tutorials-howto-assign-workspace-to-role
description: "Assign UIPage.Show and associate an Effective Workspace UI Page with a Role in MES."
---

# How to: Assign a Workspace to a Role

### 1. Go to the Administration menu.

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

### 2. Open Security.

![Screenshot showing Security in the Administration page.](images/howto_user_access_workspace01.png)

### 3. Select Roles.

![Screenshot showing Roles in the Security page.](images/howto_user_access_workspace02.png)

### 4. Choose the Role to manage Workspace access.

![Screenshot showing the selected Role.](images/howto_user_access_workspace03.png)

### 5. Open the Features subsection.

![Screenshot showing the Features subsection.](images/howto_user_access_features01.png)

### 6. Select Assign.

![Screenshot showing the Features subsection and Assign action for the selected Role.](images/howto_user_access_features02.png)

### 7. Assign UIPage.Show.

Select `UIPage.Show` so users with this **Role** can open **UI Pages**.

![Screenshot showing the UIPage.Show feature selected for assignment to the Role.](images/howto_user_access_features03.png)

### 8. Select Assign to save.

![Screenshot highlighting the Assign button.](images/howto_user_access_features04.png)

!!! info

    Also assign the features required by the widgets and operations in the Workspace, and the Data Groups needed to access its data.

    For more information, see:

    - [[user-guide-security-roles#assigning-features-to-a-role|Assigning Features to a Role]].
    - [[user-guide-security-roles#assigning-data-groups-to-a-role|Assigning Data Groups to a Role]].

### 9. Open the Workspaces subsection.

![Screenshot showing the Workspaces section for the selected Role.](images/howto_user_access_workspace04.png)

### 10. Select Manage.

![Screenshot showing the Workspaces section for the selected Role.](images/howto_user_access_workspace05.png)

### 11. Add the Workspace.

Select :material-plus: and choose the Effective **Workspace** UI Page to associate with this **Role**.

![Screenshot showing the Workspace added to the Role.](images/howto_user_access_workspace06.png)

### 12. Select Update.

![Screenshot showing the Update action in Manage Workspaces.](images/howto_user_access_workspace07.png)

The **Role** now has the **Workspace** association and the `UIPage.Show` feature.

!!! info
    For more information, see:

    - [[tutorials-howto-give-user-workspace-access]].
    - [[tutorials-howto-create-workspace]].