You won't be able to add any mailboxes (Users) until you verify the domain ownership. **Unverified domains will be removed after 24 hours.**
**Tip: Managing Local Delivery** By default, our system routes emails locally between domains hosted on our servers, even if your MX records still point to your old provider. To avoid delivery errors during your transition, set **Local Delivery** to **No**. You can change this back to **Yes** once all your users are added and your MX records are officially pointed to us.
--- ### 1.2. Verify Domain Ownership After you add a domain, you must verify that you own it. Domain ownership is verified by adding a specific TXT record to the domain’s DNS settings at your domain registrar or DNS provider. The verification record uses the hostname `mx-verification`. This name is only used for domain ownership verification. It does not change your MX records, does not affect your current email routing, and does not affect email deliverability under your current setup.**Important: unverified domains are removed after 24 hours.** If the `mx-verification` TXT record is not found within 24 hours after the domain is added, the domain is automatically deleted from the Admin Panel. If this happens, add the domain again and repeat the verification steps.
#### #### Get the verification TXT record After the domain is added, it appears in the domain list with a **Fail** health status. This means the domain still needs to be verified. **[](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-2-click-on-verify-to-see-the-txt-necessary-to-verify-domain-ownership-hover.JPG)** 1. Locate the newly added domain in the domain list. 2. Click the **Verify** button, shown as a **red checkmark icon**. 3. Copy the DNS record details from the pop-up window. The pop-up shows the required values: - **Hostname**: `mx-verification` - **Type**: `TXT` - **Value**: Copy the unique value shown in your pop-up window. [](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-3-copy-the-txt-value-for-domain-verification-and-add-it-to-your-dns.JPG) #### Add the TXT record to your DNS 1. Log in to your domain registrar or DNS provider. 2. Open the DNS settings for the domain. 3. Add a new **TXT** record using the **hostname** and **value** shown in the verification pop-up. 4. Save the DNS record. DNS changes can take time to become visible. If the domain is not verified right away, wait a few minutes and check again. #### What happens after verification When the TXT record is found, the domain is verified. After verification: - The domain no longer appears in red in the domain list. - The red **Verify** checkmark no longer appears. - The domain ownership **Status** changes from Unverified to **Enabled**. - The domain **Health** status may still show as **Fail.** This is expected until the recommended DNS records, such as MX and SPF, are added and detected. [](https://wikidev.emailarray.com/uploads/images/gallery/2025-09/admin-panel-add-new-domain-domain-is-verified-when-the-red-checkmark-disappears.PNG) --- ### 1.3. Improve Domain Health After domain ownership is verified, you should configure the recommended DNS records for the domain. These records help email work correctly and improve the domain health status in the Admin Panel.If you are planning an email migration for this domain, you may choose to postpone making changes to critical records like MX records until the migration process is complete to avoid any disruption to your current email flow.
#### Open the domain health status 1. In the [Admin Panel](https://admin.emailarray.com), go to the **Domains** list. 2. Click the domain’s health status, such as **Fail**, to open the domain health details. [](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-4-click-to-see-domain-health-status-see-more-details.JPG) 3. The **Domain health** pop-up shows the status of important DNS records and related checks, including: *MX records, Webmail record, Webmail SSL, Autodiscover record, Autodiscover SSL, Autoconfig record, Autoconfig SSL and SPF Record*A domain **Status** of **Disabled** means domain ownership has not been verified. A status of **Enabled** means domain ownership has been verified.
[](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-5-check-domain-health-details.JPG) #### #### Recommended DNS records When you are ready, follow the [**DNS Configuration guide**](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration "DNS Configuration") to set up the following records correctly: - **MX records -** These direct incoming emails for your domain to the correct mail servers. They are crucial for receiving emails. - **SPF record** - This is a TXT record that lists authorized mail servers permitted to send emails on behalf of your domain, helping to prevent email spoofing and improve deliverability. - **Webmail record** (optional) - This is typically a CNAME record that allows you to access your webmail interface via a custom URL (e.g., `webmail.yourdomain.com`). - **Autodiscover / Autoconfig records** (optional) - These records simplify the process of configuring email clients (like Outlook / Thunderbird or mobile email apps) by allowing them to automatically discover server settings. **Webmail, Autodiscover and Autoconfig SSL:** After the Webmail, Autodiscover, or Autoconfig DNS records are found for the first time, **the matching SSL certificate is generated automatically**. You do not need to take any extra action.SSL generation can take up to 30 minutes after the DNS record is first detected. After about 30 minutes, click **Refresh** in the **Domain health** pop-up to check the updated SSL status.
#### #### Update the domain health status The **Domain health** pop-up includes two actions: **Verify again** and **Refresh.** ##### Verify again Click **Verify again** to queue a new DNS check for the domain. The result is not shown instantly. Wait up to 60 seconds, then click **Refresh** to display the updated health status. Use **Verify again** after you add, remove, or change DNS records for the domain. ##### Refresh Click **Refresh** to reload the current domain health status shown in the pop-up. **Refresh** does not start a new DNS check. It only updates the status displayed in the Admin Panel. #### Automatic domain health checks The system checks domain health automatically during the first 3 days after a domain is added. Automatic checks run: 1\. After the domain is added 2\. About 4 hours later 3\. About 8 hours after that 4\. At increasing intervals during the first 3 days After the first 3 days, automatic checks stop. If you change DNS records after that time, you must click **Verify again** to queue a new DNS check. Wait 1 to 2 minutes, then click **Refresh** to view the updated health status. --- ## 2. Remove a Domain - Navigate to the **[Admin Panel](https://admin.emailarray.com/)**. - Log in using your **Admin username and password**. - Click on **Domains** in the menu. - Click on the delete icon next to the domain you wish to remove - An alert pop up will appear, showing the domain that will be deleted. Click on **Delete** to confirm.Removing a domain will PERMANENTLY erase all domain data from our servers, including all the users' messages, the aliases, lists, and all preferences.
--- ## 3. Edit a Domain - Go to the **[Admin Panel](https://admin.emailarray.com/)**. - Log in using your **Admin username** and **password**. - Click on **Domains** in the menu. - Click on the **edit icon** next to the domain you wish to edit - You can edit the following information: - Domain-level **Timezone.** Set regional defaults for the entire domain. - Domain-level **Home Country**. Helps with detecting unusual logins. - **Catchall.** Manage mail sent to non-existent addresses. - Enable / disable **Local Delivery.** This can be useful in these cases: 1. By default, our system routes emails locally between domains hosted on our servers, even if your MX records still point to your old provider. To avoid delivery errors during your transition, set **Local Delivery** to **No**. You can change this back to **Yes** once all your users are added and your MX records are officially pointed to us. 2. You want to forward your emails to another email address but you don't want to keep a local copy - set **Local Delivery** to **No**. - Enable / disable **Audit** domain. Monitor domain-wide mail activity ([click here for details](#bkmrk-domain-auditing-%26-co)).You cannot change the name of a domain. The only way to accomplish this is to create the domain with the new name (correct a misspelling, add a hyphen, etc.) and then request a migration from the old domain to the new one by opening a support ticket.
--- ## 4. Catchall A **Catchall** address allows you to capture messages destined for non-existing mailboxes. It can help you salvage important messages that were sent to mistyped addresses. Still, on the other hand, it will surely cause you to receive many Spam emails sent via a dictionary attack, where the sender puts commonly used aliases. To enable a **Catchall**: - Go to the [Admin Panel](https://admin.emailarray.com/). - Log in using your Admin username and password. - Click on **Domains** in the menu. - Click on the **edit icon** next to the domain you wish to edit - In the **Domain Catchall** field, you can choose from the following: - **No catchall:** this disables the catchall feature - **Accept & Delete:** the catchall will automatically delete all the messages received - **Username:** the catchall will forward all received messages to the selected Username (mailbox) --- ## 5. Domain Auditing & Compliance The **Audit Domain** feature is an essential administrative tool for compliance, security, and record-keeping. By enabling this, the system captures a "Blind Carbon Copy" (BCC) of emails for oversight without disrupting the user's experience. #### Step 1: Enable Auditing for the Domain Before configuring specific rules, you must first activate the audit capability for the entire domain. 1. Navigate to the [**Admin Panel**](https://admin.emailarray.com/). 2. In the side menu, click on **Domains** in the side menu. 3. Click on the **edit icon** next to the domain you wish to monitor. 4. Locate the **Enable / disable Audit domain** setting. 5. Toggle the setting to **Enabled**. 6. Click **Update** to save your settings. 7. Once enabled, our system automatically creates a management sub-domain in the format *audit.yourdomain.com*. #### Step 2: Create the Audit Storage Mailbox Now that auditing is enabled, you need a specialized account to receive and store the intercepted emails. 1. Navigate to the [**Admin Panel**](https://admin.emailarray.com/). 2. In the side menu, click on **Users** in the side menu. 3. Select the newly created audit domain (e.g., audit.yourdomain.com) from the domain dropdown menu. 4. Click the **New** button 5. In the pop-up window, select "**Audit Account**" from the **Account Type** dropdown 6. Fill in the username (e.g., archive) and set a secure password 7. Click **Add** to finish. #### Step 3: Configure Interception Rules Finally, define exactly which communications the system should capture and where they should go. 1. Navigate to the [**Admin Panel**](https://admin.emailarray.com/). 2. Go to **Compliance** in the side menu. 3. Select the **audit** sub-domain from the dropdown. 4. Click **New** to add a rule. 5. Set your preferences in the **New** window: [](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/admin-panel-compliance-add-a-new-rule.PNG) - **Audit type:** Check **Incoming** to capture mail sent *to* your domain, and **Outgoing** for mail sent *from* your domain. - **Entry:** Specify what to monitor. Enter the **full domain** to audit all users, or a **specific email address** for a single user. - **Audit email:** Select the destination **Audit Account** you created in Step 2. 6. Click **Add** to activate the rule. > **Note:** Enabling this feature will capture all incoming and / or outgoing messages for every user on the domain. Ensure your designated audit mailbox has sufficient storage capacity to handle the volume of traffic. --- ## 6. Set a Footer (Domain Level) A **domain-level Footer** will show up in all the emails that all the users of the domain send. To add a domain **Footer**: - Go to the [Admin Panel](https://admin.emailarray.com/). - Log in using your Admin username and password. - Click on **Domains** in the menu. - Click on the **footer icon** next to the domain you wish to update - Fill in the Footer message using the available HTML editor. - Click on **Update** to finish. --- ## 7. Setup Branding (Domain Level) While [global branding can be set at the Admin level](https://wikidev.emailarray.com/books/3-admin-panel-manage-users-domains-aliases-and-more/page/set-branding), you can also override those settings to provide a unique identity for a specific domain. **Steps to Configure Domain Branding:** - Go to the [Admin Panel](https://admin.emailarray.com/). - Log in using your Admin username and password. - Go to **Domains** > **Branding** in the Admin Panel sidebar. - **Select Domain:** Choose the specific domain you wish to customize from the drop-down menu. - **Update Details:** Fill in the branding information, including the company name, website link, support email for spam reports, and primary brand color. - **Upload Logo:** Directly upload a logo from your device. For the best display within the Webmail interface, aim for an image that fits or matches the **210px x 35px** aspect ratio. - **Save Changes:** Click on **Update Settings** to apply the branding to that specific domain. - **Revert Changes:** If you wish to remove the domain-specific customization and return to your global settings, click on **Reset to Admin Defaults**. ---