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

# Manage Tyk Dashboard User Groups

> Learn how to organize Tyk Dashboard users into user groups (teams) to simplify role assignment and permissions management

export const ButtonLeft = ({href, color, content}) => {
  const buttonStyle = {
    display: 'inline-block',
    padding: '5px 16px',
    fontSize: '14px',
    fontWeight: '500',
    textDecoration: 'none',
    borderRadius: '25px',
    transition: 'all 0.2s ease',
    cursor: 'pointer',
    border: '1.2px solid black'
  };
  const colorStyles = {
    green: {
      backgroundColor: '#20EDBA',
      color: 'black'
    },
    red: {
      backgroundColor: '#dc2626',
      color: 'white'
    },
    black: {
      backgroundColor: '#1f2937',
      color: 'white'
    }
  };
  const hoverStyle = {
    transform: 'translateY(-1px)',
    boxShadow: '0 4px 8px rgba(0,0,0,0.15)'
  };
  const finalStyle = {
    ...buttonStyle,
    ...colorStyles[color] || colorStyles.black
  };
  return <a href={href} style={finalStyle} onMouseEnter={e => {
    Object.assign(e.target.style, hoverStyle);
  }} onMouseLeave={e => {
    e.target.style.transform = 'translateY(0)';
    e.target.style.boxShadow = 'none';
  }}>
      {content}
    </a>;
};

Tyk has a flexible [user permissions](/docs/platform-management/user-permissions) system that provides Role Based Access Control (RBAC) for your Tyk Dashboard.

When you have a large number of users and teams with different access requirements, instead of setting permissions per *user*, you can create a *user group* and configure the permissions for all users in the group. For example, if you only want certain *users* to access the Tyk Logs, you could create a "Logs Users" *user group*, then give those users the *Logs Read* permission and add them to your *Logs Users* group.

Note that **a user can only belong to one group**.

You must have either *admin* or *user groups* permission to be able to modify user groups.

This also works for Single Sign-On (SSO), as you can specify the user group ID when setting up SSO.

<Note>
  The availability of this feature depends on your license.

  <br />

  For further information, please check our [price comparison](https://tyk.io/price-comparison/) or consult our sales and expert engineers:

  <ButtonLeft href="https://tyk.io/contact/" color="green" content="Contact us" />
</Note>

## Using Dashboard UI

1. **Select "User Groups" from the "System Management" section**

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_groups_menu.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=ad39e32aa04f6dbb7ecf3335fa83e512" alt="User group menu" width="246" height="303" data-path="img/2.10/user_groups_menu.png" />

2. **Click "ADD NEW USER GROUP"**

   <img src="https://mintcdn.com/tyk/XYIZ0Oo5nzDVrYaM/img/2.10/add_user_group.png?fit=max&auto=format&n=XYIZ0Oo5nzDVrYaM&q=85&s=b9ea3482e46f165c76cd6f89f56b72d4" alt="Add user group location" width="407" height="135" data-path="img/2.10/add_user_group.png" />

3. **Add User Group Name**

   Enter the name for your User Group, and an optional Description.

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_group_details.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=4eee05adcdf6d18fc463d0f3989e81ff" alt="Add name" width="1198" height="421" data-path="img/2.10/user_group_details.png" />

4. **Set User Group Permissions**

   Selet the User Group Permissions you want to apply.

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_group_permissions.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=5047ca1d6acc13edcdbf5cecd698c65a" alt="Add permissions" width="1180" height="813" data-path="img/2.10/user_group_permissions.png" />

5. **Click "Save" to create the Group**

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_group_save.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=af2a6fbafbd3a9f23724a89ab995d922" alt="Click Save" width="298" height="137" data-path="img/2.10/user_group_save.png" />

6. **Add Users to your Group**

   1. From the **Users** menu, select **Edit** from the **Actions** drop-down list for a user to add to the group.
   2. Select your group from the **User group** drop-down list.

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_select_group.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=c81aee518203409ede26cb76db3534bc" alt="select user group" width="1160" height="266" data-path="img/2.10/user_select_group.png" />

   Click Update to save the User details

   <img src="https://mintcdn.com/tyk/_n1j2nedxXfbDX-s/img/2.10/user_reset_password.png?fit=max&auto=format&n=_n1j2nedxXfbDX-s&q=85&s=da7033022e567841d0eb7c80965d75ec" alt="update user" width="601" height="136" data-path="img/2.10/user_reset_password.png" />

## Using Dashboard API

You can also manage User Groups via our [Dashboard API](https://tyk.io/docs/api-reference/usergroup/list-user-groups). The following functions are available:

* [List all User Groups](https://tyk.io/docs/api-reference/usergroup/list-user-groups)
* [Get a User Group via the User Group ID](https://tyk.io/docs/api-reference/usergroup/get-user-group-details)
* [Add a User Group](https://tyk.io/docs/api-reference/usergroup/create-user-group)
* [Update a User Group](https://tyk.io/docs/api-reference/usergroup/update-user-group)
* [Delete a User Group](https://tyk.io/docs/api-reference/usergroup/delete-user-group)