Manage DNS records

When you add a new site to Cloudflare, Cloudflare automatically scans for common records and adds them to the DNS zone. The records show up under the respective zone DNS > Records page.

Note

The DNS records quick scan is not automatically invoked in the following cases:

• If you choose Enterprise plan and, instead of the Quick Scan, choose to upload a DNS zone file or add records manually.
• If you add a zone via the API.

You can manually invoke the quick scan via API with the Scan DNS Records endpoint.

Note that the quick scan is a best effort attempt based on a predefined list of commonly used record names and types. You can read more about this in the reference page.

Since this scan is not guaranteed to find all existing DNS records, you need to review your records, paying special attention to the following record types:

• Zone apex records (example.com)
• Subdomain records (www.example.com or blog.example.com)
• Email records

If you want more control over which DNS records are imported and how, import a zone file.

Note

If your domain is added to Cloudflare by a hosting partner, manage your DNS records via the hosting partner.

Create DNS records

Dashboard

To create a DNS record in the dashboard:

1. Log in to the Cloudflare dashboard ↗ and select an account and domain.

2. Go to DNS > Records.

3. Click Add record.

4. Choose a record Type.

5. Complete the required fields, which vary per record. Particularly important fields (for some records) include:

   • Proxy status: For A, AAAA, and CNAME records, decide whether hostname traffic is proxied through Cloudflare.
   • TTL: Short for Time to Live, this field controls how long each record is valid and — as a result — how long it takes for record updates to reach your end users.
   • Comment and Tag: Record attributes meant for your reference.

6. Click Save.

API

To create records with the API, use a POST request. For field definitions, select a record type under the request body specification.

For specific API examples, refer to DNS record types.

---

Edit DNS records

Dashboard

To edit DNS records in the dashboard:

1. Log in to the Cloudflare dashboard ↗ and select an account and domain.
2. Go to DNS > Records.
3. On a specific record, click Edit.
4. Make any necessary changes.
5. Click Save.

API

To update part of a record with the API, use a PATCH request. If you want to overwrite the entire existing record, use a PUT request.

---

Delete DNS records

Dashboard

To delete DNS records in the dashboard:

1. Log in to the Cloudflare dashboard ↗ and select an account and domain.
2. Go to DNS > Records.
3. On a specific record, click Edit.
4. Click Delete.
5. Click Delete again to confirm.

API

To delete records with the API, use a DELETE request.