User Permissions

Elevate, May 20-22-2025, Miami Beach, Florida

Choose how users in a Team can access various entities in the Merchant Center.

This page describes user permissions in the Merchant Center. For information about API Client permissions, see Authorization and Scopes.
Learn more about setting up Permissions in our self-paced learning module.

The Merchant Center grants permissions based on a user's Team. A Team can belong to only one Organization. An Organization can have as many Teams as necessary, and a user can belong to more than one Team in more than one Organization. You can assign permissions to a Team for multiple Projects in an Organization. If a user belongs to more than one Team, then permissions are additive and the user receives all the permissions granted to them by all Teams that they belong to.

You can assign the following permissions:

  • View permissions: members of a Team can view, but not edit or delete.
  • View and edit permissions: members of a Team can view, edit, and delete.
    • Action Rights: some permissions have additional action rights, which control specific editing actions in a permission group. Action rights are a subset of view and edit permissions, scoping view and edit permissions to specific aspects of a particular area in the Merchant Center.
  • Menu item permissions: members of a Team can hide navigation items from the main menu.

A Team can have view or edit permissions to a section of the Merchant Center, which is hidden from their menus.

Permissions are assigned to a specific Project in an Organization, and not to all Projects.

View and edit permissions are workflow-based. If users have permissions to access a workflow, then the permissions are configured to make sure that all related data relationships needed for the workflow are fulfilled. For example, the Orders permission grants access to several APIs such as Customers, Payments, States, and Discount Codes.

Administrators manage user permissions within an Organization. For more information about the Administrators team and their role in an Organization, see Administrators Team.

Reference: permissions and action rights

With view-only permissions, users can view but not modify the contents of a page. However, with view and edit permissions, they can both view and modify the page's content.

By default, all Merchant Center pages have access to the information stored in Project settings.

Products

View all: Products: grants permission to view information on the following pages:
  • Product list
  • Direct Product access
  • Product details
View and edit all: Products: grants permission to view, edit, and add Products on the following pages:
  • Product list
  • Direct Product access
  • Product details

Some functionalities on the previously mentioned pages depend on the following granted action rights:

Add embedded prices
  • Adds new Embedded Prices to existing Products.
  • Activates the Add price button on Product Variant pages.
  • Activates the Add tier price button when creating a new Price.
  • Implicitly grants view access to Customer Groups because they can be used while creating Prices.
Edit embedded prices
  • Edits the existing Embedded Prices of a Product.
  • Implicitly grants view access to Customer Groups because they can be used while modifying Prices.
Delete embedded prices
  • Deletes the existing Embedded Prices of a Product.
  • Activates the delete icon on the Manage the price page.
Add products
  • Activates the Add Products button on the Product list page.
  • Grants access to all Add Product pages.
  • Implicitly grants view access to certain fields in Product Types, Categories, Product Discounts, and Customer Groups because they are used while creating Products.
Delete products
  • Activates the Delete option in the Actions list on the Product list page.
  • Activates the delete icon on the respective Product details page.
Publish products
  • Activates the Status list on the Product details page.
  • Activates the Publish option in the Actions list on the Product list page.
Unpublish products
  • Activates the Status list on the Product details page.
  • Activates the Unpublish option in the Actions list on the Product details page.
Edit attributes
  • Edit all: grants permission to edit all Attributes.
  • Edit only attributes assigned to the following Attribute group(s): grants permission to edit Attributes assigned to the selected Attribute Group.

Product Selections

View all: Product Selections: activate read-only mode for the following pages:
  • Product Selection list
  • Assigned Products tab in the Product Selection details page. View Products attached to a Product Selection.
  • Stores tab in the Product Selection details page
  • Product Selections tab in the Product details page. View Product Variants assigned to a Product Selection.
View and edit all: Product Selections: grants permission to view, add, update, and delete Product Selections and manage their assigned Products:
  • Product Selection list
  • Add Product Selection
  • Enables Assigned Products tab in the Product Selection details page. View assigned Products and manage their assignments.
    • If granted within a conditional permission, assignments can be managed only for Product Selections matching the specified data fence (for example, Product Selections linked to "Store A" and "Store B").
  • Enables Stores tab in the Product Selection details page.
  • Enables Product Selections tab in the Product details page. Assign, edit, and remove Product Variants from Product Selections.
    • If granted within a conditional permission, only Product Variants matching the specified data fence (for example, Product Selections linked to "Store A" and "Store B") can be assigned to Product Selections.
  • Enables Bulk assign products to product selections action in the Product list. Assign Product Variants to Product Selections in bulk.
    • If granted within a conditional permission, only Product Variants matching the specified data fence (for example, Product Selections linked to "Store A" and "Store B") can be assigned in bulk to Product Selections.

      To manage Product assignments within a Product Selection (including editing or assigning via the Assigned Products tab or using bulk assignment), a user must also have at least the View all: Products permission. Without this permission, assignment-related actions will not be available even if all Product Selection permissions are granted, including for conditional (store-based) permissions.

Categories

View all: Categories: activate read-only mode for the following pages:
  • Categories list
  • Category details
  • Category search
View and edit all: Categories: grants permission to view, edit, and add Categories on the following pages:
  • Categories list
  • Category details
  • Category search
  • Add category

Customers

View all: Customers: activate read-only mode for the following pages:
  • Customers list
    • If granted within a conditional permission, then only those Customers who match the specified data fence (for example, Customers of Store A) and global Customers (not bound to any Store) are listed.
  • Customer details
    • If granted within a conditional permission, then only those Customers who match the specified data fence (for example, Customers of Store A) and global Customers (not bound to any Store) can be accessed.
View and edit all: Customers: grants permission to view, edit, and add Customers on the following pages:
  • Customers list
    • If granted within a conditional permission, then only those Customers who match the specified data fence (for example, Customers of Store A) and global Customers (not bound to any Store) are listed.
  • Customer details
    • If granted within a conditional permission, then only those Customers who match the specified data fence (for example, Customers of Store A) and global Customers (not bound to any Store) can be accessed. However, global Customers can only be accessed in read-only mode.
  • Add customer
    • If granted within a conditional permission, then the Account restricted to these stores field is mandatory and one or more Stores that match the specified data fence must be selected.

Customer Groups

View all: Customer groups: activate read-only mode for the following pages:
  • Customer group list
  • Customer group details
View and edit all: Customer groups: grants permission to view, edit, and add Customer Groups on the following pages:
  • Customer group list
  • Customer group details
  • Add customer group

Orders

View all: Orders: activate read-only mode for the following pages:
  • Dashboard
  • Orders list
    • If granted within a conditional permission, then only those Orders that match the specified data fence (for example, Orders from Store A) are listed.
  • Order details
    • If granted within a conditional permission, then only those Orders that match the specified data fence (for example, Orders from Store A) can be accessed.
View and edit all: Orders: grants permission to view, edit, and add Orders on the following pages:
  • Dashboard
  • Orders list
    • If granted within a conditional permission, then only those Orders that match the specified data fence (for example, Orders from Store A) are listed.
  • Order details
    • If granted within a conditional permission, then only those Orders that match the specified data fence (for example, Orders from Store A) can be accessed.
  • Add order
    • If granted within a conditional permission, then the Store that matches the specified data fence must be selected at the beginning of the flow.

Granting view and edit permissions to Orders implicitly grants view access to certain fields in Customers, Products (and all dependencies of Products, such as Product Discounts), Discount Codes, and Cart Discounts while using the Add order page.

Some functionalities on the previously mentioned pages depend on the following granted action rights:

Add order
  • Activates the Add Order button on the Order list page.
  • Activates the Add Order menu item under Orders in the Merchant Center main menu.
  • Activates the Copy this Order button on the Order details page.
  • If granted with a conditional permission, then the conditional permission will be overruled by general permissions (Order action right).
Add discount code
  • Activates the Apply button in the Applied Cart Discount section on the Shopping cart page.
  • If granted with a conditional permission, then the conditional permission will be overruled by general permissions (Order action right).
Create return:
  • Activates the Create Return button in the Returns tab on the Order details page.
  • If granted with a conditional permission, then the conditional permission will be overruled by general permissions (Order action right).

Standalone Prices

View all: Standalone Prices: activate read-only mode for the following pages:
  • Standalone price list
  • Standalone price details
View and edit all: Standalone Prices: grants permission to view, edit, and add Standalone Prices on the following pages:
  • Add prices
  • Edit prices
  • Delete prices

Product Discounts

View all: Product discounts: activate read-only mode for the following pages:
  • Product discounts list
  • Product discount details
View and edit all: Product discounts: grants permission to view, edit, and add Product Discounts on the following pages:
  • Product discounts list
  • Product discount details
  • Add discount (Product Discount button only)

Granting view and edit permissions to Product Discounts implicitly grants view access to certain fields in Products and Categories while using the Add Product Discount page.

Cart Discounts

The conditional permissions set is not exclusive in the following instances:

  • Cart Discounts that require a Discount Code can be linked to a Discount Code created by any user.
  • When a Custom Field references Cart Discounts, all Cart Discounts will be visible.
View all: Cart discounts: activate read-only mode for the following pages:
  • Cart discounts list
    • If granted within a conditional permission, then only those Cart Discounts that match the specified data fence (for example, Cart Discounts from Store A) are listed.
  • Cart discount details
    • If granted within a conditional permission, then only those Cart Discounts that match the specified data fence (for example, Cart Discounts from Store A) can be accessed.
View and edit all: Cart discounts: grants permission to view, edit, and add Cart Discounts on the following pages:
  • Cart discounts list
    • If granted within a conditional permission, then only those Cart Discounts that match the specified data fence (for example, Cart Discounts from Store A) can be accessed.
  • Cart discount details
    • If granted within a conditional permission, then only those Cart Discounts that match the specified data fence (for example, Cart Discounts from Store A) can be accessed.
  • Add discount (Cart Discount button only)
    • If granted within a conditional permission, then only those Cart Discounts that match the specified data fence (for example, Cart Discounts from Store A) can be accessed.

Granting view and edit permissions to Cart Discounts implicitly grants view access to certain fields in Customers, Customer Groups, Products, and Categories while using the Add Cart Discount page.

Discount Codes

Discount Codes must be used with a Cart Discount. While granting access to Discount Codes, make sure that the user group also has access to Cart Discounts.

View all: Discounts codes: activate read-only mode for the following pages:
  • Discount Code list
  • Discount Code details
View and edit all: Discounts codes: grants permission to view, edit, and add Discount Codes on the following pages:
  • Discount Code list
  • Discount Code details
  • Add discount (Discount Code button only)

Granting view and edit permissions to Discount Codes implicitly grants view access to certain fields in Cart Discounts while using the Add Discount Code page.

Quotes

View all: Quotes: activate read-only mode for the following pages:
  • Quote list
    • If granted within a conditional permission, then only those Quotes that match the specified data fence (for example, Quotes from Store A) are listed.
View and edit all: Quotes: grants permission to view, edit, and add Quotes on the following pages:
  • Quote list
    • If granted within a conditional permission, then only those Quotes that match the specified data fence (for example, Quotes from Store A) are listed.

Business Units

View all: Business Units: activate read-only mode for the following pages:
  • Business unit list
    • If granted within a conditional permission, then only those Business Units that match the specified data fence (for example, Business Units of Store A) are listed.
  • Business unit details
    • If granted within a conditional permission, then only those Business Units that match the specified data fence (for example, Business Units of Store A) can be accessed.
View and edit all: Business Units: grants permission to view, edit, and add Business Units on the following pages:
  • Business unit list
    • If granted within a conditional permission, then only those Business Units that match the specified data fence (for example, Business Units of Store A) are listed.
  • Business unit details
    • If granted within a conditional permission, then only those Business Units that match the specified data fence (for example, Business Units of Store A) can be accessed.
  • Add business unit
    • If granted within a conditional permission, then only those Business Units that match the specified data fence (for example, Business Units of Store A) can be accessed.

Audit Log

View all: Audit log: activate read-only mode for the following page:
  • Change history

Operations

View all: Operations: activate read-only mode for the following pages:
  • Import logs
  • Export logs
View and edit all: Operations: grants permission to view the following page:
  • Upload files

Project settings

To manage other aspects of a project such as Organizations and Teams, you must be a member of the Administrators Team.
View all: Project settings: activate read-only mode for the following page:
  • Project settings
View and edit all: Project settings: grants permission to view, edit, and add Project settings on the following page:
  • Project settings
For more information about the items you can configure by using Project settings, see Project Settings.

Product Types

View all: Product types: activate read-only mode for the following page:
  • Product types
View and edit all: Product types: grants permission to view, edit, and add Product Types on the following page:
  • Product types

Attribute Groups

View all: Attribute groups: activate read-only mode for the following page:
  • Attribute groups
View and edit all: Attribute groups: grants permission to view, edit, and add Attribute Groups on the following page:
  • Attribute groups

Developer settings

With Developer settings, you can control which members of a Team can create API Clients and use the API Playgrounds and GraphQL Explorer. We recommend that you restrict access to only those members who need it.
View all: Developer settings: activate read-only mode for the following page:
  • Developer settings
View and edit all: Developer settings: grants permission to view, edit, and add developer settings on the following page:
  • Developer settings