Title: Add a domain
Author: WordPress VIP Documentation
Published: February 1, 2021
Last modified: March 27, 2026

---

 1. [Domains](https://docs.wpvip.com/domains/)
 2. Add a domain

#  Add a domain

Custom domains must be added to an environment’s VIP Dashboard in order to be used
for [launching a site](https://docs.wpvip.com/launch-a-site/) or [sending emails from an environment with that domain](https://docs.wpvip.com/wordpress-on-vip/email/send-from-custom-domain/).

After adding a custom domain, [the domain must also be verified](https://docs.wpvip.com/domains/verification/)
before DNS settings can be provided and a Let’s Encrypt certificate can be installed.

## Access

**Prerequisites**

To add a domain to an application’s environment, a user must have at minimum an 
[Org member role](https://docs.wpvip.com/manage-user-access/vip-dashboard/org-roles/)
or an [App write role](https://docs.wpvip.com/app-role/) for that application.

Domains have specific [application](https://docs.wpvip.com/application/) and [environment](https://docs.wpvip.com/vip-platform/environments/)
associations.

 1. Navigate to the [VIP Dashboard](https://dashboard.wpvip.com/) for the application
    that the domain should be associated with.
 2. Select the environment that the new domain will point to (e.g., production, develop)
    from the dropdown located at the upper left of the dashboard.
 3. Select “**Domains & TLS**” from the sidebar navigation at the left of the screen.

## Add a domain

**Note**

A domain can only be mapped to a single application. It must be removed before it
can be used on another application.

Within the “**Domains & TLS**” panel of an environment’s VIP Dashboard:

 1. Select the button labeled “**Add Domain**” located in the upper right of the panel.
 2. Enter the desired `www` or non-`www` version of the domain into the available field.
    The version entered in this field is the [fully qualified domain name (FQDN)](https://docs.wpvip.com/domains/fqdn/)
    that will be used for any associated site launches.
 3. Select the button labeled “**Add**“.

Within 10 minutes the added domain will appear in the list of domains associated
with the environment.

After a domain has been added, [the domain must be verified](https://docs.wpvip.com/domains/verification/)
before DNS instructions can be accessed and before a Let’s Encrypt certificate can
be installed. Only verified domains can be used for launching a site or sending 
emails.

![](https://docs.wpvip.com/wp-content/uploads/sites/2/2024/11/Domains-TLS.png?w=
1024)

Screenshot of the **Domains & TLS** panel of the VIP Dashboard

## Remove a domain

Remove a domain only after confirming that the domain is no longer being used to
route public traffic to a site on the environment, and it is not being used to [send emails](https://docs.wpvip.com/wordpress-on-vip/email/)
from the environment.

Within the “**Domains & TLS**” panel of an environment’s VIP Dashboard:

 1. Select the “•••” button located to the right of the domain.
 2. Select “**Remove**” from the overflow menu.
 3. Select the button labeled “**Confirm**” to complete the removal.

### Remove a primary domain

A domain cannot be removed from the VIP Dashboard if it is currently assigned as
the environment’s [primary domain](https://docs.wpvip.com/domains/primary-domain/).
By replacing the current primary domain with a different custom domain, it will 
become eligible for removal.

 * **On a WordPress multisite environment**, the primary domain assigned to the 
   main site (ID 1) can be updated in the [launch tooling in the Network Sites panel](https://docs.wpvip.com/launch-a-site/begin-a-multisite-launch/)
   of the VIP Dashboard.
 * **On a WordPress single site environment**, the primary domain must be updated
   by [submitting a VIP Support request](https://wordpressvip.zendesk.com/).

Last updated: March 27, 2026