Skip to main content

Add a Domain to a WordPress Site

This article explains how to add, verify, and manage primary domains and additional domains for a WordPress site, including DNS and SSL configuration.

Updated over 2 months ago

Who This Is For / When to Use

Use this guide if you want to:

  • Connect a custom domain to a WordPress site.

  • Add additional domains or sub-domains to an existing WordPress site.

  • Configure DNS and SSL for WordPress-hosted domains.

  • Manage primary domain settings and domain status.


Before You Start

  • Your WordPress site must already be created.

  • You must have access to your domain provider’s DNS settings.

  • DNS propagation can take up to 48 hours depending on the provider.


Navigate to Domain Management

  1. Go to Sites > WordPress.

  2. Open your WordPress Dashboard.

  3. Locate the Manage Your Domains section.

  4. Click Add Domain.


Adding a Primary Domain

A primary domain is the main address for your WordPress site. All additional domains redirect to the primary domain.


Step 1: Add Your Domain Name

  1. Enter your domain name (example: example.com).

  2. Click Continue.

  3. The system checks whether the domain is already associated with another account.

If the domain is available, you will move to SSL configuration.


Step 2: Configure SSL Certificate

To secure your domain with HTTPS, SSL records must be added.

  1. Add the first TXT record with the key _acme-challenge and the provided value.

  2. Add the second TXT record with the key _cf-custom-hostname and the provided value.

  3. Set TTL to 600 ms (or the lowest available).

  4. Save the records in your DNS provider.

Notes:

  • SSL records usually propagate within an hour.

  • Global propagation may take up to 48 hours.


Step 3: Update DNS Records

After SSL verification, point the domain to your WordPress site.

  1. Add the A record with:

    • Host/Key: @

    • Value: Provided IP address

  2. Add the CNAME record for www if required.

  3. Set TTL to 600 ms (recommended).

  4. Click Verify DNS Record.

Important:

  • If your DNS provider is Cloudflare, turn off Proxy settings (DNS only).

  • DNS propagation may take up to 48 hours.


Domain Verification Status

While DNS records propagate, you may see a pending or warning state.

  • Verified records show a green Verified status.

  • Unverified records indicate DNS propagation is still in progress.


Setting a Primary Domain

Once multiple domains are added:

  1. Open the domain options menu (three dots).

  2. Select Set as Primary Domain.

Only one domain can be set as primary at a time.


Adding Additional Domains or Sub-Domains

Additional domains or sub-domains follow a simplified process.

Key Differences

  • TXT records are not required for additional domains.

  • SSL is verified automatically during DNS verification.

Steps

  1. Click Add Domain.

  2. Enter the additional domain or sub-domain.

  3. Add the provided A or CNAME record to your DNS provider.

  4. Click Verify DNS Record.

Once verified, the domain will redirect to the primary domain.


Managing Domains Dashboard

The Domains dashboard provides full visibility and control.

You can:

  • View SSL issuance status.

  • Check DNS verification status.

  • Add up to 5 domains per site.

  • Change the primary domain.

  • Switch between www and non-www prefixes.

  • Delete existing domains.

Each domain displays clear status indicators:

  • SSL Issued / SSL Not Issued

  • Verified / Not Verified


Common Issues and Fixes

Domain not verifying

  • Confirm DNS records match exactly.

  • Ensure TTL is set to 600 ms.

  • Wait up to 48 hours for propagation.

SSL pending for too long

  • Recheck TXT records.

  • Verify there are no duplicate SSL records.

Using Cloudflare

  • Disable Cloudflare Proxy (orange cloud).

  • Use DNS-only mode until verification completes.


FAQ

Can I add both a root domain and a www domain?

Yes. The system supports both root and www domains. The www domain uses a CNAME record.

How many domains can I add?

You can add up to five domains per WordPress site.

Do additional domains need SSL TXT records?

No. Only the first domain requires TXT records. Additional domains verify SSL during DNS validation.

What happens if I delete a domain?

You can re-add it later, but DNS and SSL verification may take time to complete again.

How long does DNS propagation take?

Most providers update within an hour, but global propagation can take up to 48 hours.

Did this answer your question?