Add Domain in User Portal

This process will link your domain name to your WordPress environment on WP Engine.
Mapping a domain to your environment should be done when you are ready to “go live” with your WordPress website, or make it available at a custom domain of choice. This is typically done before modifying DNS records.


Navigate to Domains Page

The Domains page of your User Portal is where you will find and manage information related to your website’s domain. Items you can find on this page include your WP Engine CNAME, IP address, mapped domains and whether or not your mapped domains are pointed correctly.

  1. Log in to the User Portal
  2. Click Sites at the top of the page
  3. Select the production environment name from the list
  4. Click Domains on the left

Shared hosting plans: Custom domains can only be added to your Production environment. Custom domains cannot be added to Staging, Development, Legacy Staging or Transferrable sites.

Premium dedicated hosting plans: Custom domains can be added to Production, Staging and Development environments as-needed.


Add New Domain

A new domain must be added to the WP Engine User Portal in order to properly route the domain to the intended WordPress website. Be aware that in most cases where you are not simply pointing a subdomain, both the www and non-www version should be added to the User Portal.

  1. From the Domains page, click Add domain
  2. Enter your new domain in pop up window
    • In the example below, I want my website to be hosted at somecooldomain.com
  3. Click Next

If you’ve entered either a www or non-www domain, after clicking Next, both domains including the www and non-www variation will be added to the User Portal. As shown below:

NOTE: If you receive the error “Domain name has already been taken”, check out the Duplicate Domain section below.

Next, you will be prompted to configure DNS records. Follow any additional prompts, as desired, to configured DNS and SSL. These options do not need to be complete immediately and the prompts can be exited any time if you’re not ready to update DNS and finish going live.

Domain Connect

If you choose to follow the prompts to configure DNS and your domain provider supports Domain Connect, you will be prompted to have your DNS configured for you automatically. Simply log in to your DNS provider’s dashboard using the button prompt.

Learn more about Domain Connect.

Provision Let’s Encrypt Certificates

At the end of the optional prompts, our system will also offer to automatically provision free Let’s Encrypt SSL certificates for your domain. This can help ensure your site is secured as soon as possible after pointing DNS.

Learn more about Let’s Encrypt SSL certificates.


Primary Domain

Your website can ultimately only resolve to only one domain in the browser, we call this the Primary Domain. The Primary Domain can impact redirects and copying between environments, so it’s important to set this correctly when going live. The Primary Domain can only be one of the following:

  • A domain without “www
    • EX: mydomain.com
  • A domain withwww
    • EX: www.mydomain.com
  • A subdomain
    • EX: blog.mydomain.com

NOTE: A Primary domain cannot be a subdirectory (EX: domain.com/blog). For more information, review this guide.

Set Primary Domain

  1. Log in to the User Portal
  2. Select the Production environment name from the list
  3. Click Domains
  4. Next to a domain, click the 3 dot menu icon
  5. Click Set as Primary


Domain-level Redirect

A domain-level redirect is useful because it tells the entire server to immediately send requests to one domain to another. For example, if your primary domain is “mydomain.com” requests to “www.mydomain.com” should immediately forward.

Doing this as a domain-level redirect in the User Portal will ensure this is set as high-level and be performed as quickly as possible.

It 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.

Set Domain-level Redirect(s)

  1. Select the environment name from the Sites page of the User Portal
  2. Click Domains
  3. Locate the domain you wish to redirect
  4. Click the 3 dot menu icon to the right
  5. Select Add Redirect
  6. From the dropdown, select the domain you’d like to Redirect to
    • The dropdown will default to your Primary Domain
  7. Click Save Changes

Edit/Remove Domain-level Redirect

Incorrectly setting your domain-level redirects can cause a redirect loop. Additionally, if you’re attempting to set a 301/302 redirect from the User Portal and cannot select the desired domain from the dropdown, there is like a conflicting domain-level redirect set.

To edit or remove an existing domain-level redirect:

  1. Click the 3 dot menu next to the domain
  2. Click Edit Redirect
  1. Click the dropdown for Redirect to
  2. Select –No Redirect– or an alternate domain option
  3. Save changes


Duplicate Domains

A custom 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. You will see either of the following errors if you try to add a domain that is already associated with another Environment.

Domain name has already been taken

Or

Domain name is already configured as a domain on the install “xyz”. Please choose a unique name.

If you encounter one of these errors, please remove the domain from other Environments before attempting to add it to this one. If you see this error but cannot locate the domain name on your account, please contact WP Engine Support and they will help verify ownership of the domain.


NEXT STEP: Update your website’s URL in WordPress

Still need help? Contact support!

We offer support 24 hours a day, 7 days a week, 365 days a year. Log in to your account to get expert one-on-one help.

The best in WordPress hosting.

See why more customers prefer WP Engine over the competition.