# User Groups

User Groups allow administrators to organise users into named groups and control what each member can see and do within the group. Each group also has its own **Shared Contact List** — a set of contacts accessible to all group members — and a **Contact Form Builder** to customise the contact fields used in that list.

To access User Groups, go to **Settings** → **Users** → **User Groups** under the Organization Settings section of the sidebar.

The actions on the very right of the table allows to refresh the table as well as to select multiple users. With the multiselect you can directly assing a role to the selected users.

## How to create a user group

1. Click **Add new user group** at the top of the list.
2. Enter a **Group name** in the dialog.
3. Click **Create**. The group appears in the list immediately.


## How to rename a user group

1. Click **Detail** next to the group you want to rename.
2. Click **Rename user group** next to the group name at the top of the detail page.
3. Enter the new name and confirm.


## How to delete a user group

1. In the User Groups list, click the **delete** (trash) icon at the right of the group row.
2. Confirm the deletion. This action cannot be undone.


## Searching for user groups

Use the **Search user groups** field (top right) to filter the list by group name. Results update as you type.

## User Group Details

Click **Detail** on a group row to open the group detail page. It has three tabs:

### Tab 1 — Users & Permissions

This tab shows all members of the group and the permissions each one has been granted.

#### How to add a user to the group

1. Click **Add users**.
  1. You will be directly navigated to the permissions page to add the user and to instantly add the right permissions for the user. Additionally a Role can be set for the user.
2. Search for the user by name or email address.
3. Select the user and adjust the permissions and the role.
4. Save the configuration.
  1. You will be redirect back to the list of users page.


#### Permission columns

Each user row has the following permission columns. Enable the toggle to grant the permission:

| Permission | What it allows |
|  --- | --- |
| **Users View** | View the list of members in the group |
| **Users Edit** | Add, edit, and remove group members |
| **Envelopes Manage** | Perform actions on envelopes shared with the group (remind, cancel, delete, view details, download JSON, view history) |
| **Envelopes Share** | Share envelopes with group members |
| **Templates Manage** | Perform actions on templates shared with the group (delete) |
| **Templates Share** | Share templates with group members |
| **Contacts View** | View contacts in the group's Shared Contact List |
| **Contacts Edit** | Add, edit, and remove contacts in the Shared Contact List |
| **Contacts Customize** | Customise the contact form fields via the Contact Form Builder |
| **Business Role** | Assign the user to one of the available business roles |


#### How to remove a user from the group

1. Find the user in the list.
2. Click the button next to the "Edit" button to remove a user from a user group.


### Tab 2 — Shared Contact List

The Shared Contact List is a set of contacts that all members of the group can access when addressing envelopes. It acts as a shared address book for the group.

#### How to add a contact to the Shared Contact List

1. Select the **Shared Contact List** tab.
2. Click **Add new contact** or **import contacts from CSV**
3. Fill in the contact fields: **Given Name**, **Surname**, **Email**, **Phone Number**, **Language (optional)**.
4. Save the contact. It immediately becomes available to all group members.


#### How to search for a contact

Use the **Search contacts** field (top right) to filter the list by any contact field.

#### How to edit or delete a contact

In the actions column you can find two buttons to either edit the contact or to delete the contact.

### Tab 3 — Contact Form Builder

The Contact Form Builder defines which fields are available when adding contacts to this group's Shared Contact List. The standard fields (Given Name, Surname, Phone Number, Email, Language) are always present and cannot be removed.

#### How to add a custom field

1. Select the **Contact Form Builder** tab.
2. Click **Add custom field**.
3. Enter a name for the custom field.
4. Click **Save** to apply the change. The new field will appear in the **Add new contact** form for this group.


> **Note:** Custom fields added here apply only to contacts in this group's Shared Contact List, not to the personal Contacts section.