User Portal Domain Management

Adding a domain in the User Portal should be done when you are ready to go live with your WordPress website and should be done before modifying DNS records. This process is necessary to ensure that after DNS is pointed, your traffic can be routed to the correct environment.

---

Add Domain in User Portal

A new domain must be added to the WP Engine User Portal in order to properly route the domain to the intended WordPress website.

A custom domain can be added to any Production environment. Additionally, Premium plans may add a custom domain to Staging and Development environments.

1. Log in to the User Portal
2. Select the production environment name
3. Choose Domains from the secondary left-hand navigation menu
4. Click Add Domain on the right

5. Domain – Enter your domain name into the field.
6. Also add … – Choose whether to also add the common variant. Depending on the domain entered above, this will be the same domain with or without “www”.
7. Set this domain as Primary – Sets the domain entered as the Primary domain in the User Portal. Learn more about the Primary domain here.
8. Does this domain currently have live traffic?
   • Yes – If your site is currently receiving live traffic at the domain name entered. Pre-verification options will be displayed on the next page. Learn more about the pre-verification process here.
   • No – If your site is not currently live on the domain, or not currently receiving live visitor traffic, select No.
9. Click Add domain

10. DNS Details: To finish going live, DNS must be pointed to WP Engine.

• Option 1: Automatically – If available, log in to the domain provider to point DNS automatically. Learn more about Domain Connect here.
• Option 2: Manually – If domain connect is not available, or not needed, point DNS to WP Engine manually. Learn more about manually updating DNS here.

If domain pre-verification options are presented, skip to the section below.

---

Verify Domain Ownership

Global Edge Security and the advanced network utilize a highly performant Edge network. This network allows WP Engine to configure performance and security benefits on your behalf, such as CDN and SSL. To perform these tasks, domain ownership must be verified when pointing DNS to WP Engine. This verification process happens automatically after pointing DNS, and can take anywhere from a few minutes to 4 hours.

If a domain is currently serving live traffic, this downtime can be minimized by pre-verifying domain ownership. Domain pre-verification confirms domain ownership by checking for a uniquely generated TXT record before DNS is pointed to WP Engine.

Domains that are not currently serving live traffic do not need to pre-verify. Domain verification will occur automatically without pre-verification. Additionally, a domain that is already pointed to WP Engine does not need to pre-verify if moved to another environment.

Domain Pre-Verification

1. From the “Domains” page, click Add Domain
   • Enter the domain name
   • Select whether or not to include the common variant (either “www” or “non-www” depending on which was entered previously)
   • Select whether or not to set the domain as Primary in the User Portal
   • Under “Does this domain server live traffic” select Yes
   • Click Add Domain
2. On the next page, scroll to “Choose verification method” and select Pre-verify
   • IMPORTANT: Do not log in to the domain provider to point DNS automatically, OR point DNS manually yet.
3. Click Continue
   • You will be returned to the main “Domains” page while the verification details are generated by Cloudflare.
   • This typically only takes a few minutes. You may need to refresh the page.
4. Expand the domain’s status dropdown
5. Under “Domain ownership not verified” click Pre-verify domain

6. Log in to the DNS provider and add a TXT record with the name and value exactly as shown.
   • Adding a TXT record is only for verification purposes and does NOT affect live traffic.
   • Certain DNS management services may require adding cf-custom-hostnames instead of cf-custom-hostname.yourdomain.com as the name/host.
   • If there is already a TXT record for _cf-custom-hostname, delete it and replace it with the record provided.
   • Example record:

7. Click OK, I’ve done this to return to main “Domains” page in the WP Engine User Portal
8. Refresh Status to fetch the updated pre-verification status
   • Expand the domain status dropdown, under “Domain ownership not verified” click Refresh status OR expand the three dot menu icon and select Refresh Status

9. When domain ownership has been verified:
   • The DNS status will read DNS not pointed (verified) and when the domain status is expanded the “Domain ownership not verified” banner will no longer be displayed.
   • This verification status check typically takes a few minutes. You may need to refresh the page.

10. After the domain has been verified, it’s time to point DNS.
11. Expand the domain and click Go to point DNS page

• Option 1: Automatically – If available, log in to the domain provider to point DNS automatically. Learn more about Domain Connect here.
• Option 2: Manually – If domain connect is not available, or not needed, point DNS to WP Engine manually. Learn more about manually updating DNS here.

After DNS has been updated, the status shown on the main “Domains” page will be updated automatically. To manually start the fetching process, click Refresh Status in the expanded “Status” dropdown or under the three dot menu icon.

Once DNS has been verified as pointing to the advanced network or Global Edge Security, Cloudflare’s SSL will enable automatically after a few minutes, and no additional SSL should be added. If additional SSL is added to the advanced network, it will not be applied. If additional SSL is applied to GES, it can be viewed on the SSL page instead.

---

Primary Domain

The “primary” domain is a WP Engine configuration setting designed to help ensure domain and platform functionality operate as expected. The primary domain should be set to the main domain of the environment that will resolve in the browser once live. In a multisite, this is the main site domain.

The primary domain has many functions, but most significantly it’s used when running the automated database search and replace when copying or restoring a site. Be sure to set the correct primary domain when going live.

1. Next to the domain that should be made primary, open the 3 dot menu icon
2. Click Set as Primary

---

Domain-level Redirect

A domain-level redirect tells the WP Engine platform to immediately send requests from one domain to another. For example, if your primary domain is mydomain.com then requests to www.mydomain.com should immediately forward. Doing this as a domain-level redirect in the User Portal will ensure the redirect can be performed as quickly as possible. A domain-level redirect will also ensure any 301/302 redirects configured in the User Portal for a domain will function for all domains redirected to it, now and in the future.

1. Locate the domain name to redirect
2. Click the 3 dot menu icon to the right
3. Select Add redirect

4. From the dropdown, select the domain you’d like to Redirect to
5. Click Save Changes

You may find that redirecting at the domain level impedes a redirect set elsewhere, causing a broken redirect or a redirect loop. Additionally, if you’re attempting to set a 301 or 302 redirect from the User Portal and cannot select the desired domain from the dropdown, there is like a conflicting domain-level redirect set. In cases such as these, the domain-level redirect would need to be removed or updated to another domain.

---

Duplicate Domains

To ensure your domain can direct traffic to the intended environment, a domain can only be applied to one environment at a time. The same domain cannot be added to multiple environments across any WP Engine accounts. The following error will be shown if attempting to add a domain that is already associated with another environment.

Validation failed: Name is already in use on different backend. Please choose a unique name.

Delete the domain name from the existing environment before adding it to the desired environment. The search bar at the top of the User Portal can be used to search for the domain across all of the accounts you have access to.

Duplicate Domain Dispute Process

If you do not have access to the environment where the domain is currently applied, you will need to verify ownership of the domain so we can move it on your behalf.

Log in to your DNS host and add the following TXT record:

wpe-verification=yourenvironmentname

Be sure to replace yourenvironmentname above record with the specific name of the environment you’d like the domain added to, or we will not be able to verify the record.

Finally, contact WP Engine Support and we will help verify ownership via this DNS record add it to your User Portal.

---

Domain Status

Updating a website’s DNS can be overwhelming. With over 130,000 customers hosted on WP Engine, we know the struggles of managing tons of domains. We want to make it easy to understand the status of your domain’s DNS records and if they are properly configured to serve traffic from your WP Engine environment.

The domain SSL, DNS, and Network statuses are displayed in columns next to each domain in the User Portal on the main “Domains” page. 

If a change has been made, the status can be checked by clicking Refresh Status under the three dot menu icon.

Domain Status Descriptions

SSL – Indicates if the SSL has been enabled or not. Learn more about SSL here. SSL is enabled automatically when using the advanced network and Global Edge Security networks.

• Error
  • There is no SSL certificate, or the domain is not accessible.
• Expired
  • The SSL certificate has expired.
• Enabled
  • SSL has been added.
  • When using the advanced network, Cloudflare SSL is the only type applied, regardless of any additional SSL installed.
  • When using Global Edge Security, Cloudflare SSL is applied automatically. Additional SSL status can be viewed on the SSL page.

Network – The network this domain uses. Compare network options here.

• Legacy Network
  • This is the legacy network address. DNS should no longer be pointed to this legacy CNAME, as it will reach end-of-life in the future.
  • The advanced network domain or Global Edge Security (GES) domain should be used when pointing DNS instead.
• Advanced Network
  • WP Engine’s more performant and secure advanced network. In most cases, DNS will be pointed to the advanced network.
  • Read about the advanced network here.
• Global Edge Security
  • Global Edge Security is a paid add-on and will be applied at a network level to increase security and performance. If GES is applied to your plan, DNS should be pointed to this network.
  • Learn more about GES here.

DNS – Current domain verification and DNS state at the last check.

• DNS not pointed (not verified)
  • Domain ownership is not verified, and DNS has not been pointed to WP Engine.
  • Domain verification occurs after pointing DNS to WP Engine. Speed this process up by pre-verifying the domain before pointing DNS.
• DNS not pointed (verified)
  • Domain ownership has been verified, and DNS has not been pointed to WP Engine. Learn how to point DNS here.
• Pointed
  • DNS has been confirmed pointing to WP Engine.
  • Also displays the detected DNS provider, where DNS is pointed from.

NEXT STEP: Update your website’s URL in WordPress