---
title: Role Creation Guide
slug: user-documentation/role-creation-guide
docTags: 
createdAt: 2024-05-08T18:37:27.900Z
---

Creating and managing user roles effectively is crucial for maintaining security and ensuring appropriate access within the UpStart Commerce Portal. In this guide, we'll take you through the step-by-step process of creating and managing user roles within the UpStart Commerce Portal Users Management section. From creating new roles to editing existing ones, we'll cover everything you need to know to optimize your users management operations. Here's how you can access, create, and edit user roles.

# Accessing the Users Management Section

To access the **Users Management** page in the UpStart Commerce portal, enter your credentials to log in. Once logged in, navigate to the **Users Management** section from the left menu panel. 

Initiate the new role creation process by clicking the** + Create New Role **icon in the top-right corner of the **Roles** page.

![](https://lh7-us.googleusercontent.com/LriJEg91rBsWHBK5zsGBi7HsZH5WjZikSokWRkYtf3-HYRzHZPLK8RxuOmK1bEy_n_V23PvRYa--2hRpx6e-oRWdn9qB4Rxg0h6tQJgnIA3_BT1ztGwHtS8inyx5YPXRmUxQksk9oGdiroa6QFTNPQ)

## Step 1: Creating a New Role

On the **Create Role** page, input the following set of details:

### Associate to Website

Select the site from the **Site List** dropdown menu to associate the role with that specific site within the UpStart Commerce Portal. This ensures that the role's permissions are applied only to the chosen website for targeted access control.

### Role Details

In the Role Details section, input the following set of details to distinguish the new role:

- **Role Name: **Enter a unique and descriptive role name in the designated field. The role name should reflect the responsibilities and access levels associated with the role, making it easy to identify and differentiate from other roles.
- **Role Description: **Provide a detailed description of the role's purpose, responsibilities, and access privileges. This description helps users understand the role's scope and ensures clarity regarding its intended use. A well-defined role description facilitates effective role assignment and management.

Moreover, you can use the toggle button to **Enable** or **Disable** the role upon creation.

![](https://lh7-us.googleusercontent.com/4xEEPX4yfj9axvR4xhmEo_JKtbx1KR2H8oovke_STeK9qHxOvmPz8O-n51BsTNyO_YoejxUB237ZFV7wuddxrVeOyulEJO4zN_HUatmi9f2oZvjOz_nHzwda3r5WSEwBFqSooBJHmZLyWuiFE_TgKg)

### Add Permissions

Click on the **Add permissions for this role** button to access a list of available permissions. These permissions are predefined within the system and cannot be created anew. Search the permissions list using the **Search Bar** at the top and select the appropriate permissions from the list to assign to the role.

![](https://lh7-us.googleusercontent.com/s9fAdWoJwCGP8CmbkON2ilDUyp4vTjK9Pdunzubm-22y69WeNd7bnFfk7vInk8TC8QvWVUa1qQs4lZtGVU_yRRY02bZE17O3jquWpThUplxvcMEznvJlV3kq5MsN35AKAsAwRqLla2M5OQJf7B2kRg)

![](https://lh7-us.googleusercontent.com/fbgcVWgPBHrBrVumAeuwB0uO--chUS3sXmHpkmm3i3ffi5aNzHwtn4WDzE-56Zr_auULsQ4vp26yUgZKTORyHhLf0vAipxSsa0CDA4ts0hGNKTN_Mpia_rSwz4YDDQjlvdxh1JoBGoJrnLtEKnBHpQ)

## Step 2: Finalizing Role Creation

After defining the role details and adding permissions, click the **Create** button to finalize the creation of the new role. The role will now appear in the list of roles in the Roles section.

![](https://lh7-us.googleusercontent.com/5PGCKEk7BeCq5iGQ7f185--1xD7UYkNOIphPJRLuQb-ZVDFEzsmRLUog33ozhYCLK4gxvAlOycTWRdbEdYeOZvJ1qK68NLAlUhcrXYWfrdAZunifJwjyUHVAhLa_mkwx9_OhNg_AXAVsKuxEe1_R8A)

# Managing Existing Roles

Once roles are created, they can be managed further using the options available in the Roles section. Within **Users Management**, locate and click on the **Roles** section. Here, you'll find a tabular view of existing roles, displaying information such as Role ID, Role Name, Description, and Status. The following actions can be performed when you click the three-dot action menu:

## Modify Role

Modify role allows you to update the Role Name, Description, and associated permissions for an existing role. Here's a simple step-by-step guide on how to modify a role in the No Channel Portal.

**Step 1: Navigate to the Users Management Section**

Log into the UpStart Commerce Portal, access the **Users Management **section from the left menu panel, and go to the **Roles** section. 

**Step 2: Locate the Role**

Use the search bar on the **Roles** page to locate the role you wish to edit.

**Step 3: Access Role Details**

Once you've found the role, click the **Modify** option in the action menu.



![](https://lh7-us.googleusercontent.com/xWSzZXjeht5nHz31JdWdAcOG89SV1xEAv8-t3mRUbHS6uzVxfM3oMa4ffj60ogZ6deUcUHlOYncF2QFiHWO0hqOz6jlhYJV2Hxdy4vRpkQIrROlFoTkxqvA8AOtPC_JMkBxaQg5odp6Aggf5JxU8ig)

**Step 4: Modify Account Details**

On the **Edit Role: (Role Name)** page, you can either associate the role with the other website, update the role name and role description, or change the associated role permissions.  

**Step 5: Save Changes**

After making the required modifications, Click the **Save** button to save the updates.

![](https://lh7-us.googleusercontent.com/R8BzyVpY2XPE0xSMktxwdXqsPaZXJlQez32cmMcQ4A-aCSY7TVjn_dIZYIsIVQfDVj8oxvUC5lNWI8-8NCuZzQWTDQLe_l4uL6s4oU3xbKXZpixpnz3fX0D2FhkuBs7brp-39eQTwyWIyTGzWVGxcQ)

**Step 6: Assign Users to the Role (Optional)**

Once the changes have been saved on the **Edit Role: (Role Name**) page, you have the option to assign the role either globally or on a per-site basis to users.

![](https://lh7-us.googleusercontent.com/MA_tlR_v-SnYsC7ZdI9JqBVPTZBesCoQ8LFGtMefoUOAgq66rTwoKmeysdF6-YwzEW1Ga4bqPMrpUEeoNVoOKU5jJo1jSGx61dj5BEh8ChjRoLhB7xEJLKPC9OB_p5vxE3rtQ0N56YJodhEEaAnsSw)

## Modify Role Permissions

You can modify the permissions assigned to a role by selecting the **Modify Role Permissions** option from the actions menu. This enables you to add or remove permissions from the role. Here's a simple step-by-step guide on how to modify the role permissions in the No Channel Portal.

**Step 1: Navigate to the Users Management Section**

Log into the No Channel Portal, access the **Users Management** section from the left menu panel, and go to the **Roles** section. 

**Step 2: Locate the Role**

Use the search bar on the **Roles** page to locate the specific role for which you intend to modify permissions.

**Step 3: Access Add Permissions**

Once you've found the role, click the **Modify Role Permissions** option in the action menu.

![](https://lh7-us.googleusercontent.com/qTCl9vyahS_FWfDMqpNgyBg8CetadZcU40guzVbBhW9MLsNofbcTgLj1tFt4w0He0YM4VPeqlk76cX5Xa-K4JWySadLhIOF8XR1pHq4SnXoBW22udEBTL9UAWDxjFb0gO8ZkOu-_ynnUCZUdqJgEMw)

**Step 4: Modify Permissions**

On the **Add Permissions** page, search the permissions list using the **Search Bar** at the top and select the new permissions from the list to assign to the role.

![](https://lh7-us.googleusercontent.com/s9fAdWoJwCGP8CmbkON2ilDUyp4vTjK9Pdunzubm-22y69WeNd7bnFfk7vInk8TC8QvWVUa1qQs4lZtGVU_yRRY02bZE17O3jquWpThUplxvcMEznvJlV3kq5MsN35AKAsAwRqLla2M5OQJf7B2kRg)

![](https://lh7-us.googleusercontent.com/fbgcVWgPBHrBrVumAeuwB0uO--chUS3sXmHpkmm3i3ffi5aNzHwtn4WDzE-56Zr_auULsQ4vp26yUgZKTORyHhLf0vAipxSsa0CDA4ts0hGNKTN_Mpia_rSwz4YDDQjlvdxh1JoBGoJrnLtEKnBHpQ)

## Delete Role

If a role is no longer needed, you can delete it by selecting the Delete Role option from the actions menu. This action removes the role and its associated permissions from the system.

![](https://lh7-us.googleusercontent.com/CxenSJmxS2HuxLGQOrWnjik0JMbOD7HSy7BNrK366t9gjJcXye1aoGcZ0PKYJV-N_7k-al2IuBkB4-Js2r5M27-HE1CmL0Vb9bGv1wqTGM4TiZBSYR8cxMfpgsqGCZ-f1UzDOZYB9pdyqjcz0bXoJQ)