# Create user roles and assign users to them

> Group app users into roles such as Admin or Customer, then give each role its own pages, menus and data. Create, rename, delete and assign roles.

Source: https://tadabase.com/docs/users-security/roles  
Status: Verified Nov 17, 2026. Checked against the current product

A role is a group of app users who should see and do the same things, such as Admin, Dispatcher, Technician or Customer. Give pages, layouts, page sections and records access by role instead of by person, then put each user in the right role.

## What roles control

- **Pages and layouts**: let only some roles open a page, so each role gets its own portal in the same app.
- **Parts of a page**: show a section of a page only to some roles.
- **Records**: limit which records each role can see or change.
- **Login**: a Login component can let in only users with certain roles.

All roles share the same tables, so you keep one copy of your data and decide per role who sees which part of it.

## Create a role

1. **Open the Roles tab** In the **Data Builder**, open the **Users** table and go to the **Roles** tab. It lists every role with its name and description.
2. **Add the role** Click **Add a New User Role**.
3. **Name it** Enter a **Name**. Role names must be unique in the app. The **Description** is optional and only shows in the builder.
4. **Save** Click **Save** in the bar at the bottom of the screen.

![The Roles tab of the Users table listing the roles Admin, Dispatcher, Technician and Customer, with the Add a New User Role button](https://tadabase.com/docs-shots/users-security-roles-tab.webp)

> **Note:** Your plan sets how many roles an app can have. When you reach the limit, an upgrade button takes the place of **Add a New User Role**.

## Rename or delete a role

On the **Roles** tab, click the role's row to open it.

- To rename it, change the **Name** (or **Description**) and click **Save**. Users keep the role; only its name changes.
- To delete it, click **Delete** and confirm. Deleting a role removes it from every user who had it. The users themselves are not deleted, but pages, sections and logins that allowed that role no longer let them in through it.

> **Warning:** Before you delete a role, give its users another role, or they may lose access to the pages they use.

## Put users in a role

A user's roles are stored in the **Role** field of the Users table. It's a connection to the app's roles, and a user can have more than one role: they get the access of each.

- **In the builder**: open the user's record in the Users table and choose the roles in **Role**.
- **From the live app**: add the **Role** field to a Form component on the Users table so an admin can set it.

Keep the **Role** field out of the Profile component and out of any form that ordinary users can reach, so users can't give themselves a higher role.

## Next: give each role its access

- [Page and layout security](https://tadabase.com/docs/learn/page-and-layout-security): choose which roles can open each page or layout.
- [Control which records each user can see](https://tadabase.com/docs/users-security/record-level-security): limit which records each role can see or change.
- [Charge app users with Stripe subscriptions](https://tadabase.com/docs/users-security/adding-stripe-subscriptions): tie a role to a paid plan.
