Source: https://nishanth-fern-test.docs-staging.pageloop.ai/mirror/manage-approved-domains

# Manage Approved Domains

Whatfix enables you to define and manage the email domains authorized for learner authentication. This ensures that only learners with an authorized email domain can access [shared](/mirror/share-whatfix-mirror) Mirror Screens, providing a layer of security for your content against unauthorized access. For example, you can add a domain during initial setup or remove an outdated domain when your organization's email structure changes.

When a learner accesses a shared Mirror simulation, they must verify their email address against a whitelisted domain and complete OTP authentication before access is granted.

For more information, see [Set Up Email-Based Authentication](/mirror/set-up-email-based-authentication).

> [!WARNING]
>
> - You can whitelist up to 100 domains.
> - Learner email addresses used for domain whitelisting authentication are not stored or visible in Whatfix analytics.

Expand the following accordions for more details:

****Add a Domain for Whitelisting****

Whatfix enables you to add a new email domain to the whitelist to grant access to learners from that domain.

For example, the domain [whatfix.com](http://whatfix.com) on the whitelist ensures all learners with a Whatfix email address can access shared Mirror Screens.

Use the following steps to add a domain for domain whitelisting:

1. On the [Whatfix Mirror Dashboard](/mirror/how-can-i-access-the-whatfix-mirror-dashboard), click **Settings**.

![](/images/d4/Mirror_Db_Click_Settings-1-d40ecf00.png)
2\. Under **Setup**, click **Approved Domains**. ![](/images/9b/Mirror_Db_Click_Domain_whitelisting-9b126f5d.png)
3\. Click **Add Domain**.

![](/images/07/Mirror_Db_Click_Add_Domain-07e02f36.png)
4\. Enter a valid domain. For example, whatfix.com

![](/images/08/Mirror_Db_Enter_Domain_URL-081dd635.png)
5\. Click **Add**.

![](/images/69/Mirror_Db_Domain_whitelisting_click_Add-69deef6b.png)

> [!INFO]
>
> When you add a domain to the whitelist, Whatfix displays the following message:
>
> ![](/images/db/Mirror_Db_Domain_added-dbb87234.png)

****Disable a Whitelisted Domain****

Whatfix enables you to temporarily disable a whitelisted domain to block learner access without permanent removal. Once you disable a domain from the whitelisted list, all learners currently authenticated through that domain lose access immediately and see the login page instead.

For example, a disabled [partner-org.com](http://partner-org.com) domain blocks learner access during an offboarding period but remains on the whitelist for future re-enablement.

Use the following steps to disable a whitelisted domain:

1. On the [Whatfix Mirror Dashboard](/mirror/how-can-i-access-the-whatfix-mirror-dashboard), click **Settings**. ![](/images/d4/Mirror_Db_Click_Settings-1-d40ecf00.png)
2. Under **Setup**, click **Approved Domains**. ![](/images/9b/Mirror_Db_Click_Domain_whitelisting-9b126f5d.png)
3. Hover your cursor over the required domain. ![](/images/ca/Mirror_Db_Hover_Domain-1-ca9764eb.png)
4. Disable the toggle for **Status**.

![](/images/40/Mirror_Db_Domain_Whitelisting_Click_Toggle-40765f3b.png)
5\. Click **Disable**.

![](/images/ef/Mirror_Db_Domain_Whitelisting_Click_Disable-ef1a1536.png)

> [!INFO]
>
> When you disable a domain from the whitelist, Whatfix displays the following message:
>
> ![](/images/10/Mirror_Db_Disable_a_whitelisted_domain-1011cd3b.png)

> [!WARNING]
>
> Once you disable a domain, all learners authenticated through that domain lose access to shared Mirror simulations. This change might take up to 30 minutes to take effect.

****Delete a Whitelisted Domain****

Whatfix enables you to permanently delete a domain from the whitelist when it is no longer required. Once you delete a domain from the whitelisted list, this change is irreversible. All learners currently authenticated through that domain lose access immediately.

For example, after a vendor contract ends, the deleted [old-vendor.com](http://old-vendor.com) domain revokes all learner access from that domain.

Use the following steps to delete a whitelisted domain:

1. On the [Whatfix Mirror Dashboard](/mirror/how-can-i-access-the-whatfix-mirror-dashboard), click **Settings**. ![](/images/d4/Mirror_Db_Click_Settings-1-d40ecf00.png)
2. Under **Setup**, click **Approved Domains**. ![](/images/9b/Mirror_Db_Click_Domain_whitelisting-9b126f5d.png)
3. Hover your cursor over the required domain. ![](/images/ca/Mirror_Db_Hover_Domain-1-ca9764eb.png)
4. Click the **Delete** icon. ![](/images/5c/Mirror_Db_Click_Delete_icon-5ce481be.png)
5. Click **Delete.**

![](/images/eb/Mirror_Db_Domain_Whitelisting_Click_Delete-eb82dc58.png)

> [!INFO]
>
> When you delete a domain from the whitelist, Whatfix displays the following message:![](/images/50/Mirror_Db_Delete_a_Whitelisted_Domain-501fb991.png)

> [!WARNING]
>
> Once you delete a domain, this change is irreversible. This change might take up to 30 minutes to take effect.

****Edit a Whitelisted Domain****

Whatfix enables you to update an existing whitelisted domain if the domain name was entered incorrectly or has changed.

For example, an updated domain [acmecorp.com](http://acmecorp.com) reflects the corrected name without the need to delete and re-add the original [acme-corp.com](http://acme-corp.com) entry.

Use the following steps to edit a whitelisted domain:

1. On the [Whatfix Mirror Dashboard](/mirror/how-can-i-access-the-whatfix-mirror-dashboard), click **Settings**. ![](/images/d4/Mirror_Db_Click_Settings-1-d40ecf00.png)
2. Under **Setup**, click **Approved Domains**. ![](/images/9b/Mirror_Db_Click_Domain_whitelisting-9b126f5d.png)
3. Hover your cursor over the required domain. ![](/images/ca/Mirror_Db_Hover_Domain-1-ca9764eb.png)
4. Click the **Edit** icon. ![](/images/02/Mirror_Db_Click_Edit_icon-02f645a0.png)
5. Edit the domain as required. ![](/images/74/Mirror_Db_Domain_Whitelisting_Edit_domain-746dafc7.png)
6. Click **Save**.

![](/images/1f/Mirror_Db_Domain_Whitelisting_Click_Save-1fdc949d.png)

> [!INFO]
>
> When you edit a whitelisted domain, Whatfix displays the following message:![](/images/b6/Mirror_Db_Edit_a_Domain-b69837ac.png)

A replica of an application screen captured based on a UI element.
