> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing User Roles

> This help topic describes how to manage roles for the users of your managed accounts.

export const Image = ({src, alt = '', caption, width, height, shadow}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  const img = <img className={['mega-image-style', shadow ? 'shadow' : ''].join(' ')} src={src} alt={alt} width={width} height={height} style={{
    display: 'block'
  }} />;
  return caption ? <figure>
      {img}
      <figcaption style={{
    textAlign: 'center',
    width
  }}>{caption}</figcaption>
    </figure> : img;
};

export const InlineImage = ({src, alt, height = 16, shadow, width}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: InlineImage -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  if (typeof alt !== 'string') {
    alt = String(alt);
  }
  if (alt === 'undefined') {
    console.error(`${errorPrefix} \`alt\` is required (use "" for decorative images) — rendering an empty string instead`);
    return <></>;
  }
  if (height) {
    height = height.toString().replaceAll(/\D/g, '');
  }
  if (width) {
    width = width.toString().replaceAll(/\D/g, '');
  }
  return <img className={['inline-icon', shadow ? 'shadow' : null, 'm-0'].filter(Boolean).join(' ')} src={src} alt={alt} height={height} width={width} style={{
    display: 'inline',
    verticalAlign: 'middle',
    maxHeight: height ? `${height}px` : undefined,
    maxWidth: width ? `${width}px` : undefined,
    height: height ? `${height}px` : undefined,
    width: width ? `${width}px` : undefined
  }} />;
};

This topic describes user roles within managed accounts that allow different levels of access privilege.

When logged in to a partner account, you can assign user roles to control the actions and permissions of users in managed accounts. The actions and permissions change if the Service Approval Queue feature is active. These tables summarize each user role and its supported functionality, indicated by a **✓**.

For information about the Service Approval Queue feature, see [Service Approval Queue](/partners/services/service-approval-queue).

<Callout icon="triangle-exclamation" color="red">
  Only Company Admins can create managed accounts and onboard managed account users.
</Callout>

<Tabs>
  <Tab title="Partner-Managed User Accounts">
    | <br /><br />     **Action**         | <InlineImage src="/images/portal-admin/user-management/companyadmin-icon.svg" alt="" width={35} height={35} /> <br /> **Company Admin** | <InlineImage src="/images/portal-admin/user-management/technicaladmin-icon.svg" alt="" width={35} height={35} /> <br /> **Technical Admin** | <InlineImage src="/images/portal-admin/user-management/technicalcontact-icon.svg" alt="" width={35} height={35} /> <br /> **Technical Contact** | <InlineImage src="/images/portal-admin/user-management/finance-icon.svg" alt="" width={35} height={35} /> <br /> **Finance** | <InlineImage src="/images/portal-admin/user-management/financecontact-icon.svg" alt="" width={35} height={35} /> <br /> **Financial Contact** | <InlineImage src="/images/portal-admin/user-management/readonly-icon.svg" alt="" width={35} height={35} /> <br /> **Read Only** |
    | ----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------: |
    | Create managed account              |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Onboard managed account users       |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Create services                     |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | Terminate services                  |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Design services                     |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Update a service                    |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | View services                       |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Lock and unlock services            |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Create, view, and edit service keys |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | View usage                          |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Create, view, and update users      |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Update user details                 |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | View User Activity logs             |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | View Company Activity logs          |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
  </Tab>

  <Tab title="Partner-Managed User Accounts with Service Approval Queue Enabled">
    | <br /><br />     **Action**              | <InlineImage src="/images/portal-admin/user-management/companyadmin-icon.svg" alt="" width={35} height={35} /> <br /> **Company Admin** | <InlineImage src="/images/portal-admin/user-management/technicaladmin-icon.svg" alt="" width={35} height={35} /> <br /> **Technical Admin** | <InlineImage src="/images/portal-admin/user-management/technicalcontact-icon.svg" alt="" width={35} height={35} /> <br /> **Technical Contact** | <InlineImage src="/images/portal-admin/user-management/finance-icon.svg" alt="" width={35} height={35} /> <br /> **Finance** | <InlineImage src="/images/portal-admin/user-management/financecontact-icon.svg" alt="" width={35} height={35} /> <br /> **Financial Contact** | <InlineImage src="/images/portal-admin/user-management/readonly-icon.svg" alt="" width={35} height={35} /> <br /> **Read Only** |
    | ---------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------: |
    | Create managed account                   |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Onboard managed account users            |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Design services                          |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Submit new services for approval         |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | Submit service changes for approval      |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | Submit service terminations for approval |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | Withdraw a service approval request      |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | View services                            |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Lock and unlock services                 |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Create, view, and edit service keys      |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                                                                                                 |                                                             **✓**                                                            |                                                                                                                                               |                                                                                                                                 |
    | View usage                               |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | Create, view, and update users           |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
    | Update user details                      |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | View User Activity logs                  |                                                                  **✓**                                                                  |                                                                    **✓**                                                                    |                                                                      **✓**                                                                      |                                                             **✓**                                                            |                                                                     **✓**                                                                     |                                                              **✓**                                                              |
    | View Company Activity logs               |                                                                  **✓**                                                                  |                                                                                                                                             |                                                                                                                                                 |                                                                                                                              |                                                                                                                                               |                                                                                                                                 |
  </Tab>
</Tabs>

Here are some details to consider when creating user roles:

* **Company Admin** – We recommend limiting the number of Company Admins to only those who require full access, but defining at least two Company Admins for redundancy.
* **Technical Admin** – This role is for technical users who know how to create and approve orders.
* **Technical Contact** – This role is for technical users who know how to design and modify services but don't have the authority to approve orders.
* **Finance** – Finance users should have a financial responsibility within the organization while also understanding the consequences of their actions if they terminate or approve services.
* **Financial Contact** – This user role is similar to the Finance role without the ability to place and approve orders, terminate services, or administer service keys.
* **Read Only** – Read Only is the most restrictive role. Note that a Read Only user can view service details which you may want to keep secure and private. A user with the read-only role can view service details which might contain information about the service that you want to keep secure and private.

You can add user roles when you create a new user, or you can edit user information to change their role. For more information about adding a new user, see [Adding and Modifying Managed Account Users](/partners/account/user-management).

<Note>
  Only Company Admins can edit user credentials.
</Note>

**To manage user roles and permissions**

1. Log in as a Company Admin.

2. Choose User Menu > Admin Settings > Manage Users.

   <Image src="/images/partners/account/manage-users-company-menu.png" alt="Manage Users option in the Company menu" shadow={true} width={300} />

   The Manage Users page appears. This page lists existing users and you can add a new user or edit existing user privileges and contact information.

   <Image src="/images/partners/add-new-user.png" alt="Manage Users page showing that you can manage user roles and permissions by clicking Edit next to each user." shadow={true} width={700} />

3. Click <InlineImage src="/images/portal-admin/user-management/edit-user-icon.png" alt="Edit icon on the Manage Users page" height={30} />(Edit) to modify an existing user’s role or click **New User** (at the bottom of the page) to set up a new user and define their role.

4. Select the role for the user.

5. Click **Save**.
