<!-- Source: https://docs.squirro.com/en/latest/getting/self-service/domain-permissions.html -->
# Email Domain-Based Permissions

Squirro allows you to add an email domain (such as `squirro.com`) to tailor access to an instance.

Doing so allows anyone with a valid email address at the domain (such as `john@squirro.com`) to access the instance.

To add e-mail domains to an instance, follow the steps below:

## Step 1 - Add a Domain to an Instance

1. Log in to Squirro.
2. Navigate to the Cluster space (also known as the _My Instances_ page).
3. Hover over an instance you have either _Owner_ or _Administrator_ access to.
4. Click the three-dots to open the drop-down menu, then click Domains.

[![Selecting Domains from Cluster screen](https://s3.amazonaws.com/download.squirro.net/docs/technical/ui/domain-1.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/ui/domain-1.png)

1. Click Add Domain, as shown in the example screenshot below:

[![Adding a domain](https://s3.amazonaws.com/download.squirro.net/docs/technical/ui/domain-2.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/ui/domain-2.png)

1. Enter the domain you want to add, then click Save.

## Step 2 - Create a Group for the Domain

Create a user group named after the domain, using the naming convention `<domain name> Users`.

Example: For the `squirro.com` domain, name the group `squirro.com Users`.

For the steps, see the [Managing User Groups](../../technical/ui/user-groups.md#ui-user-groups) page.

## Step 3 - Add the Group to a Project

Give the group a role in each project its members need, using Setup → Settings → Project Members.

For the steps, see the [Managing User Groups](../../technical/ui/user-groups.md#ui-user-groups) page.
