Section 26 5 min read

Connect your domain: Cloudflare

Use these steps if your domain's nameservers point to Cloudflare. Cloudflare is both a registrar and a DNS provider, so this applies even if you registered your domain somewhere else but manage its DNS in Cloudflare.

You will add the DNS records shown in your Press Mage DNS Setup Instructions so your domain points to your Press Mage service.

Before you begin

Open your Press Mage DNS Setup Instructions in another browser tab: open the service, find the domain in its Domains section and click Instructions. For a domain in My Domains, the Manual DNS Setup box on its DNS page shows the same records.

You will copy these values from there:

  • The A-record IP address
  • The CNAME destination (your service's Press Mage hostname)
  • The domain or subdomain each record is for

Always use the values shown in your own DNS Setup Instructions. The examples on this page use placeholders, not real values. Each service has its own hostname, and the IP address can change, so never copy a value from an example or from another customer.

Add every record your instructions list, with the type they show. A root domain such as example.com needs both the A record and the www CNAME; a subdomain such as portal.example.com needs only its own CNAME.

How to enter the host name

Press Mage shows the complete domain name, but Cloudflare only needs the host portion.

Press Mage displays Enter in Cloudflare
example.com @
www.example.com www
portal.example.com portal
support.example.com support

Do not enter https://, http://, a page path or a trailing slash in a DNS record.

Open the DNS settings

  1. Sign in to the Cloudflare dashboard.
  2. Select your domain.
  3. Select DNS, then Records.

Cloudflare's own DNS record documentation describes the same screens.

Connect the root domain

  1. Select Add record.
  2. Select A as the record type.
  3. In Name, enter @.
  4. In IPv4 address, enter the IP address from your DNS Setup Instructions.
  5. Set Proxy status to DNS only, so the cloud icon is grey.
  6. Leave TTL set to Auto.
  7. Select Save.
Field Value
Type A
Name @
IPv4 address The IP address from your DNS Setup Instructions
Proxy status DNS only
TTL Auto

Connect the www address

  1. Select Add record.
  2. Select CNAME.
  3. In Name, enter www.
  4. In Target, enter the hostname from your DNS Setup Instructions.
  5. Set Proxy status to DNS only.
  6. Leave TTL set to Auto.
  7. Select Save.
Field Value
Type CNAME
Name www
Target The hostname from your DNS Setup Instructions
Proxy status DNS only
TTL Auto

Connect a custom subdomain

For a custom address such as portal.example.com:

  1. Select Add record.
  2. Select CNAME.
  3. In Name, enter portal.
  4. In Target, enter the hostname from your DNS Setup Instructions.
  5. Set Proxy status to DNS only.
  6. Leave TTL set to Auto.
  7. Select Save.
Field Value
Type CNAME
Name portal
Target The hostname from your DNS Setup Instructions
Proxy status DNS only
TTL Auto

Leave the records on DNS only unless Press Mage Support tells you to turn on the Cloudflare proxy. With the proxy on (orange cloud), Press Mage may not be able to verify the domain or issue its SSL certificate.

If a record already exists

You cannot normally have two conflicting records for the same host. Before adding a Press Mage record, look for an existing record with the same Name:

  • For the root domain, look for @ or the domain name.
  • For www, look for a record named www.
  • For a custom subdomain, look for that subdomain, such as portal.

If a conflicting record exists, either edit it to use the value from your DNS Setup Instructions, or delete it and create the new record.

Do not delete unrelated email records: MX records, SPF or DKIM records, DMARC records or other TXT records. If you are unsure, contact Press Mage Support before removing anything.

Verify the domain

  1. Return to your Press Mage DNS Setup Instructions.
  2. Select Verify DNS Now.
  3. If verification does not succeed yet, wait and try again later.

Many changes appear within minutes or a few hours, but full DNS propagation can take 24 to 48 hours.

Troubleshooting

Press Mage cannot verify the domain. Check that:

  • The root record is an A record with the Name @.
  • The www or custom subdomain record is a CNAME.
  • The CNAME target exactly matches the hostname in your DNS Setup Instructions.
  • You did not include https:// or a page path.
  • Every Press Mage record is set to DNS only (grey cloud).
  • No conflicting A, AAAA or CNAME record exists for the same host.

The domain is not listed in my Cloudflare dashboard. Cloudflare does not manage its DNS. Check the domain's nameservers, or ask your registrar: "Which provider currently manages the DNS records for my domain?" The changes must be made at the provider that controls the domain's nameservers.