Important

You are browsing documentation for version 5.0 of OroCommerce, supported until January 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Manage Roles in the Storefront 

Roles are predefined sets of permissions. In the Roles section, you can view, edit and create new roles to define the level of permissions and access to the actions and data in OroCommerce storefront for the users of a specific role.

To locate roles:

  1. Navigate to Account in the user menu.

  2. Click Roles in the menu on the left.

../../../../_images/Roles.png

Roles Grid 

On the All Roles page, you will be able to see the list of roles available in the system. By default, the following roles are predefined and available for every customer:

  • Administrator

  • Buyer

The roles table shows the following data:

  • Role

  • Type (Predefined, Customizable)

  • More Actions (View, Edit, Delete)

Within the table you have the following actions buttons available:

  1. Refresh the view table: click to update the view table.

  2. Reset the view table: click to clear view table customization and return to default settings. Reset applies to all filters, records per page and sorting changes that you have made.

  3. Table settings: click to define which columns to show in the table.

  4. Filters .

Role View Page 

To open a specific role: click on the selected role in the view table.

To edit a specific role from its view page: click Edit Role on the right of the page.

../../../../_images/BuyerEditRole.png

To delete a specific customizable role from its view page: click Delete

Note

If the role is predefined, it cannot be deleted. Neither can it be deleted if it is assigned to a user/users. Reassign the assigned users to a different role to be able to delete it.

../../../../_images/CustomizableRoleDelete.png

Create a New User Role 

To create a new user role, click +Create Customer User Role on the top right of the page, next to the table name.

A form will emerge with the following data to provide:

  • Customer

  • Role Title

  • Access- and permissions-related settings

../../../../_images/CreateRoleNew.png

The following permissions are available:

Permission

Level

  • View

  • Create

  • Edit

  • Delete

  • Assign

  • None

  • User (Own)

  • Department Level (Same Level)

  • Corporate (All Levels).

With the Customer User Role you can manage the following access- and permissions-related settings and capabilities:

../../../../_images/AccessPermissions.png

Field

Entities

Capabilities (Checkboxes)

All

Address, Customer User, Customer User Address, Customer User Roles, Grid (Table) View

Account Management:

  • Audit history for Customer User

  • [Quote] Enter the shipping address manually

  • [Quote] Use any shipping address from the customer address book.

  • [Quote] Use any shipping address from the customer user’s address book

  • [Quote] Use the default shipping address from the customer user’s address book

Checkout:

  • Approve orders that exceed the allowable amount

  • Enter the billing address manually

  • Enter the shipping address manually

  • Use any billing address from the customer address book

  • Use any billing address from the customer user’s address book

  • Use any shipping address from the customer address book

  • Use any shipping address from the customer user’s address book

  • Use the default billing address from the customer user’s address book

  • Use the default shipping address from the customer user’s address book.

Application:

  • Share Data View.

Account Management

Address, Customer User, Customer User Address, Customer User Role, Grid View

  • Audit history for Customer User

  • [Quote] Enter the shipping address manually

  • [Quote] Use any shipping address from the customer address book.

  • [Quote] Use any shipping address from the customer user’s address book

  • [Quote] Use the default shipping address from the customer user’s address book

Shopping

Shopping List

Quotes

Quote, Request For Quote

Checkout

Checkout

  • Approve orders that exceed the allowable amount

  • Enter the billing address manually

  • Enter the shipping address manually

  • Use any billing address from the customer address book

  • Use any billing address from the customer user’s address book

  • Use any shipping address from the customer address book

  • Use any shipping address from the customer user’s address book

  • Use the default billing address from the customer user’s address book

  • Use the default shipping address from the customer user’s address book

Orders

Invoice, Order

System capabilities

Share Data View

Note

Predefined roles cannot be edited directly. All the original data is copied so that you can save it as a new user role for your organization. All users will be moved from the original role to this new role after you click Save.

To apply a role to a specific user:

  1. Scroll down to the bottom of the Edit Role page.

  2. Enable the checkbox next to the selected user.

  3. Click Save.

../../../../_images/RolesAllUsers.png