---
title: Impersonation registry · Cloudflare Zero Trust docs
description: The impersonation registry contains combinations of emails of users
  who are likely to be impersonated. If there is an email that is on the
  impersonation registry not listed as an alternative email address, that email
  will be reported as potential business email compromise (BEC).
lastUpdated: 2025-07-02T13:48:08.000Z
chatbotDeprioritize: false
source_url:
  html: https://developers.cloudflare.com/cloudflare-one/email-security/detection-settings/impersonation-registry/
  md: https://developers.cloudflare.com/cloudflare-one/email-security/detection-settings/impersonation-registry/index.md
---

The impersonation registry contains combinations of emails of users who are likely to be impersonated. If there is an email that is on the impersonation registry not listed as an alternative email address, that email will be reported as potential [business email compromise (BEC)](https://www.cloudflare.com/en-gb/learning/email-security/business-email-compromise-bec/).

Note

The impersonation registry should contain a list of users who are likely to be impersonated. Email Security applies enhanced security to variations of registered email addresses for additional [Business Email Compromise (BEC)](https://www.cloudflare.com/en-gb/learning/email-security/business-email-compromise-bec/) protection.

For easier tracking, the Email Security team recommends syncing and structuring VIPs in groups, and avoid doing manual inputs of users.

To add a user to the impersonation registry:

1. Log in to [Zero Trust](https://one.dash.cloudflare.com/).

2. Select **Email Security**.

3. Select **Settings** > **Impersonation registry**.

4. Select **Add a user**.

5. Select **Input method**: Choose between **Manual input**, **Upload manual list**, and **Select from existing directories**:

   * **Manual input**: Enter the following information:

     * **User info**: enter a valid **Display name**.

     * **User email**: Enter one of the following:

       * **Email address**: Enter all known email addresses, separated by a comma.
       * **Regular expressions**: Must be valid Java expressions.

   * **Upload manual list**: You can upload a file no larger than 150 KB containing all variables of potential emails. The file must contain `Display_Name` and `Email`, and the first row must be the header row. Refer to [CSV uploads](https://developers.cloudflare.com/cloudflare-one/email-security/detection-settings/impersonation-registry/#csv-uploads) for an example file.

   * **Select from existing directories**:

     * **Select directory**: Select your directory.
     * **Add users or groups**: Choose the users or groups you want to register.

6. Select **Save**.

### CSV uploads

You can upload a file no larger than 150 KB containing all variables of potential emails. The file must contain `Display_Name` and `Email`, and the first row must be the header row.

An example file would look like this:

```txt
Display Name, Email
Star Phish, star@nophish.com
Phish Ee, phishee@nophish.com
```

## Edit users

Note

Administrators can edit the names and emails of users who belong to the Email Security directory. Administrators from other integrated directories cannot edit the name and the primary emails of users.

To edit users from the Email Security directory:

1. Select the user you want to edit.
2. Select the three dots > **Edit**.
3. Enter the **Display name**, **Email** and **Secondary email**.
4. Select **Save**.

To edit users from other integrations:

1. Select the user you want to edit.
2. Select the three dots > **Edit**.
3. Enter the **Secondary email**.
4. Select **Save**.

## Remove users

Note

Adiministrators can remove users who belong to the Email Security directory from the **Impersonation registry**. Users who come from an integrated directory cannot be removed from the **Impersonation registry** directly.

To remove a user from an integrated directory:

1. Select **Directories** on the sidebar.
2. Select the directory where your user is allocated.
3. Select the **Users** tab.
4. Search for the user you want to remove.
5. Select the three dots > **Remove from registry**.

To remove a user from the impersonation registry:

1. Select the user you want to remove.
2. Select the three dots > **Remove from registry**.
3. Read the pop-up message, then select **Remove user**.

To remove multiple users at once from the impersonation registry:

1. Select all the users you want to remove.
2. Select **Action** > **Remove from registry**.
3. Read the pop-up message, then select **Remove users**.
