Cloudflare Docs
DNS
Cloudflare Docs
DNS
GitHub icon
Edit this page on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. DNS
  3. ...
  4. How to
  5. Manage DNS records

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.

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:

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

​​ Create DNS records

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.

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

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

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.
To delete records with the API, use a DELETE request.