Product Home > Domains and DNS > How-Tos > Manage DNS Records

Was this page helpful?

How to Create, Edit, and Delete DNS Records

Validated on 22 May 2024 • Last edited on 8 Jul 2024 dns record | ttl | dns management | dns server

Adding a domain you own to your DigitalOcean account lets you manage the domain’s DNS records with the control panel and API. Domains you manage on DigitalOcean integrate with DigitalOcean Load Balancers and Spaces to streamline automatic SSL certificate management.

Each type of DNS record has its own values and settings, and the sections below explain what each of these records are used for and how to configure them.

Time To Live (TTL) Guidance

All DNS records have one value in common: TTL, or time to live. TTL determines how long the record remains cached in an ISP’s DNS resolver before it expires.

Keeping records cached in local resolvers across the internet helps improve your website’s performance but it may mean that your site’s users don’t see DNS updates immediately. Setting a record’s TTL is a balance between performance and propagation of changes. If you don’t intend to update record data frequently, a higher TTL like 3600 (1 hour) or 86400 seconds (24 hours) is reasonable. If you update records often, a lower TTL like 300 (5 minutes) or 600 seconds (10 minutes) ensures changes propagate more quickly.

Create, Update, or Delete Records Using the CLI

Some of these commands require you to provide the record’s ID. You can retrieve a list of records and their IDs for a domain by using the doctl compute domain records list <domain> command.

How to Add a Record Using the DigitalOcean CLI

Install doctl, the DigitalOcean command-line tool.
Create a personal access token and save it for use with doctl.
Use the token to grant doctl access to your DigitalOcean account.
```
          doctl auth init
          
```

Finally, run doctl compute domain records create. Basic usage looks like this, but you can read the usage docs for more details:

            doctl compute domain records create <domain> [flags]

The following command creates an A record for the domain example.com:

              doctl compute domain records create example.com --record-type A --record-name example.com --record-data 198.51.100.215

How to Update a Record Using the DigitalOcean CLI

Install doctl, the DigitalOcean command-line tool.
Create a personal access token and save it for use with doctl.
Use the token to grant doctl access to your DigitalOcean account.
```
          doctl auth init
          
```

Finally, run doctl compute domain records update. Basic usage looks like this, but you can read the usage docs for more details:

            doctl compute domain records update <domain> [flags]

The following command updates the record with the ID 98858421 for the domain example.com:

              doctl compute domain records update example.com --record-id 98858421 --record-name example.com --record-data 198.51.100.215

How to Delete a Record Using the DigitalOcean CLI

Install doctl, the DigitalOcean command-line tool.
Create a personal access token and save it for use with doctl.
Use the token to grant doctl access to your DigitalOcean account.
```
          doctl auth init
          
```
Finally, run doctl compute domain records delete. Basic usage looks like this, but you can read the usage docs for more details:
```
            doctl compute domain records delete <domain> <record-id>... [flags]
          
```
The following command deletes a DNS record with the ID 98858421 from the domain example.com:
```
              doctl compute domain records delete example.com 98858421
            
```

Create, Update, or Delete Records Using the API

Some of these calls require you to provide the record’s ID. You can retrieve a list of records and their IDs for a domain using the /v2/domains/$DOMAIN_NAME/records endpoint.

How to Add a Record Using the DigitalOcean API

Create a personal access token and save it for use with the API.

Send a POST request to https://api.digitalocean.com/v2/domains/{domain_name}/records

cURL

Using cURL:

                curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"type":"A","name":"www","data":"162.10.66.0","priority":null,"port":null,"ttl":1800,"weight":null,"flags":null,"tag":null}' \
  "https://api.digitalocean.com/v2/domains/example.com/records"

Go

Using Godo, the official DigitalOcean V2 API client for Go:

                import (
    "context"
    "os"

    "github.com/digitalocean/godo"
)

func main() {
    token := os.Getenv("DIGITALOCEAN_TOKEN")

    client := godo.NewFromToken(token)
    ctx := context.TODO()

    createRequest := &godo.DomainRecordEditRequest{
      Type: "A",
      Name: "www",
      Data: "1.2.3.4",
    }

    domainRecord, _, err := client.Domains.CreateRecord(ctx, "example.com", createRequest)
}

Ruby

Using DropletKit, the official DigitalOcean V2 API client for Ruby:

                require 'droplet_kit'
token = ENV['DIGITALOCEAN_TOKEN']
client = DropletKit::Client.new(access_token: token)

record = DropletKit::DomainRecord.new(
  type: 'A',
  name: 'www',
  data: '162.10.66.0'
)
client.domain_records.create(record, for_domain: 'example.com')

Python

                import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "type": "A",
  "name": "www",
  "data": "162.10.66.0",
  "priority": None,
  "port": None,
  "ttl": 1800,
  "weight": None,
  "flags": None,
  "tag": None
}

resp = client.domains.create_record(domain_name="example.com", body=req)

How to Update a Record Using the DigitalOcean API

Create a personal access token and save it for use with the API.

Send a PATCH request to https://api.digitalocean.com/v2/domains/{domain_name}/records/{domain_record_id}

cURL

Using cURL:

                curl -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"name":"blog","type":"A"}' \
  "https://api.digitalocean.com/v2/domains/example.com/records/3352896"

Python

                import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "name": "blog",
  "type": "A"
}

resp = client.domains.patch_record(domain_name="example.com", domain_record_id=2432342, body=req)

How to Delete a Record Using the DigitalOcean API

Create a personal access token and save it for use with the API.

Send a DELETE request to https://api.digitalocean.com/v2/domains/{domain_name}/records/{domain_record_id}

cURL

Using cURL:

                curl -X DELETE \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/domains/example.com/records/3352896"

Go

Using Godo, the official DigitalOcean V2 API client for Go:

                import (
    "context"
    "os"

    "github.com/digitalocean/godo"
)

func main() {
    token := os.Getenv("DIGITALOCEAN_TOKEN")

    client := godo.NewFromToken(token)
    ctx := context.TODO()

    _, err := client.Domains.DeleteRecord(ctx, "example.com", 3352896)
}

Ruby

Using DropletKit, the official DigitalOcean V2 API client for Ruby:

                require 'droplet_kit'
token = ENV['DIGITALOCEAN_TOKEN']
client = DropletKit::Client.new(access_token: token)

client.domain_records.delete(for_domain: 'example.com', id: 3352896)

Python

                import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "name": "example.com"
}

resp = client.domains.delete_record(domain_name="example.com", domain_record_id=3352896)

Create, Update, and Delete Records Using the Control Panel

You can add, modify, and delete DNS records for a domain from the Networking page. From the control panel, click the Networking in the main menu, then click on the domain you would like to manage.

To create a record, select the record type below the heading, fill in the fields required for that record type, and then click Create record. The supported record types section below provides detailed configuration instructions for each type.

To modify or delete a record, open the record’s More menu.

DNS record more menu expanded with Edit record and Delete options visible

Click Edit record to change the values for that record. To permanently delete the record, click Delete, then click Delete Record in the confirmation window.

Supported Record Types

A Records

An A record maps an IPv4 address to a domain name. This determines where to direct any requests for a domain name.

On DigitalOcean, A records have the following fields.

HOSTNAME defines the hostname or subdomain to map. This can be:
- The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
- A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.
- A wildcard (*). Wildcard records direct requests for a non-existent subdomain to a specified resource or IP address. For example, if you type help.example.com into your browser and the domain example.com doesn’t have a DNS record for that subdomain, the wildcard record directs you to the resource or IP address specified in its WILL DIRECT TO field. However, if any kind of DNS record exists for a subdomain, the existing record takes priority and the wildcard record is not applied. In this case, you need to explicitly define an A record for the subdomain. To create a wildcard record, enter a * into the HOSTNAME field.

WILL DIRECT TO defines the resource or IP address to direct queries to. This can be:

A DigitalOcean Droplet or Load Balancer by typing its name into the field and selecting it from the menu.
A non-DigitalOcean resource by entering its IP address.

Setting an A record using DigitalOcean DNS looks like this:

In this example, the hostname is set to www. This instructs the DNS to direct traffic looking for www.example.com to the specified Droplet, ubuntu-1gb-sfo2-01 with the IP address 203.0.113.5.

Note

It is possible to add multiple records for the same DNS entry, each pointing to a different IP address. This supports a load distribution and balancing strategy known as Round Robin DNS.

AAAA Records

An AAAA record, also called a Quad A record, maps an IPv6 address to a domain name. This determines where to direct requests for a domain name in the same way that an A record does for IPv4 addresses.

On DigitalOcean, AAAA records have the following fields.

HOSTNAME defines the hostname or subdomain to map. This can be:
- The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
- A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.
- A wildcard (*). Wildcard records direct requests for a non-existent subdomain to a specified resource or IP address. For example, if you type help.example.com into your browser and the domain example.com doesn’t have a DNS record for that subdomain, the wildcard record directs you to the resource or IP address specified in its WILL DIRECT TO field. However, if any kind of DNS record exists for a subdomain, the existing record takes priority and the wildcard record is not applied. In this case, you need to explicitly define an A record for the subdomain. To create a wildcard record, enter a * into the HOSTNAME field.

WILL DIRECT TO defines the resource or IP address to direct queries to. This can be:

A DigitalOcean Droplet by typing its name and selecting it from the menu. The menu displays all of your Droplets but you can only select Droplets with IPv6 addresses. DigitalOcean Load Balancers do not currently support IPv6.
A non-DigitalOcean resource by entering its IPv6 address.

Setting an AAAA record using DigitalOcean DNS looks like this:

In this example, the hostname is set to www. This instructs the DNS to direct traffic looking for www.example.com to the specified Droplet, ubuntu-1gb-sfo2-01 with the IP address 2001:0d8:2:d0::24:9001.

CNAME Records

A CNAME record defines an alias for an A record and points one domain to another domain instead of an IP address. When the associated A record’s IP address changes, the CNAME directs traffic to the new address.

On DigitalOcean, CNAME records have the following fields.

HOSTNAME defines the subdomain prefix for the new alias you want to create.
IS AN ALIAS OF defines the hostname where the alias points to. For the alias to work, the target hostname must have an A record or be handled by a wildcard A record. This can be:
- The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
- A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.

Setting an CNAME record using DigitalOcean DNS looks like this:

In this example, the subdomain staging.example.com directs traffic to the domain’s apex (@), example.com.

MX Records

An MX record specifies the mail servers responsible for accepting email on behalf of your domain. Providers often make multiple name servers available so that if one is offline, another can respond. Each server needs its own MX record.

On DigitalOcean, MX records have the following fields.

HOSTNAME specifies the domain the record applies to. In most cases, this field is set to the apex of your domain (@).
MAIL PROVIDERS MAIL SERVER specifies the hostname that contains the A record for your mail provider’s server.
PRIORITY indicates the order in which the mail servers are contacted. If you have multiple MX records, outgoing mail servers attempt to deliver the email to the record with the lowest priority first. This field takes a positive whole number where 1 is the highest priority.

The Add Gmail MX Records add records for each of Google’s mail servers automatically for use with G Suite.

Setting an MX record using DigitalOcean DNS looks like this:

In this example , the hostname is set to the apex domain @, indicating it applies to the entire domain. The MX record specifies that mail for example.com should be delivered to the mail server mail.example.com with a priority of 1.

TXT Records

A TXT record is used to associate a string of text with a hostname. These are primarily used to verify that you own a domain.

On DigitalOcean, TXT records have the following fields.

VALUE contains the text string associated with the hostname, such as example_name=example_value.
HOSTNAME defines the hostname or subdomain the record applies to. This can be:
- The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
- A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.

Setting a TXT record using DigitalOcean DNS looks like this:

TXT record with google-site-verification token entered

In this example, the record is located at the apex of the hostname example.com and contains a Google site verification string to prove ownership of the hostname.

SPF Records

Sender Policy Framework (SPF) records contain lists of email servers that are authorized to send email on behalf of your domain. SPF records increase your email sending reputation with inbox providers by providing a means to check that your emails are being sent from your domain and not by a malicious user.

SPF records are special TXT records. You can create them using the TXT record option in the control panel.

Setting an SPF record using the TXT record option looks like this:

In this example, the SPF record is located at the apex of the domain, example.com, and the record’s value authorizes an IP address (in CIDR notation) and an email provider to send email on example domain’s behalf.

DKIM Record

Domain Keys Identified Mail (DKIM) records contain public keys used to authenticate email arriving from a domain. When you use DKIM on your email server, your server signs emails with a private key that receiving email servers then validate using the public key contained in a DKIM DNS record. DKIM records increase your email sending reputation with inbox providers by providing a means to check that no one has intercepted or altered the email during transit.

DKIM records are special TXT records. You can create them using the TXT record option in the control panel.

Creating a DKIM record using the TXT record option looks like this:

In this example, the HOSTNAME field contains a domain key prefix and the VALUE field contains the public key for that domain key. This allows receiving email servers to validate that emails for example.com were signed by the private key corresponding to this public key.

NS Records

NS records specify the name servers, or servers that provide DNS services, for a domain or subdomain. You can use these to direct part of your traffic to another DNS service or to delegate DNS administration for a subdomain.

On DigitalOcean, NS records have the following fields.

HOSTNAME specifies the domain or subdomain the record applies to. This can be:
- The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
- A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.
- A wildcard (*). Wildcard records direct requests for a non-existent subdomain to a specified resource or IP address. For example, if you type help.example.com into your browser and the domain example.com doesn’t have a DNS record for that subdomain, the wildcard record directs you to the resource or IP address specified in its WILL DIRECT TO field. However, if any kind of DNS record exists for a subdomain, the existing record takes priority and the wildcard record is not applied. In this case, you need to explicitly define an A record for the subdomain. To create a wildcard record, enter a * into the HOSTNAME field.

WILL DIRECT TO specifies the name server’s hostname to direct DNS queries to for the specified hostname.

Creating an NS record using DigitalOcean DNS looks like this:

In the example, the WILL DIRECT TO field specifies that name server queries for the subdomain support.example.com are directed to the name server ns1.example.net.

Note

When you add a domain to DigitalOcean DNS, NS records pointing at DigitalOcean’s name servers are automatically created for it.

SRV Records

SRV records specify a hostname and port number to direct certain types of traffic to particular servers. Some services, like SIP (Session Initiation Protocol) and XMPP/Jabber (Extensible Messaging and Presence Protocol), require SRV records.

On DigitalOcean, SRV records have the following fields.

HOSTNAME specifies the symbolic for the service followed by the service’s transport protocol (UDP or TCP), in the following format: _service._protocol. For example, to create a record for a SIP service that uses UDP, the value would look like this: _sip._udp.

WILL DIRECT TO, which can be set to:

The apex of a domain (@). To map an apex domain, like example.com, to an IPv4 address, enter the @ symbol.
A subdomain prefix, such as www. To create a subdomain, enter a subdomain prefix. For example, to create www.example.com, enter www in the field.
A fully qualified domain name (FQDN), such as fqdn.example.com.. To use an FQDN, enter the FQDN with a period (.) at the end. This distinguishes it from a subdomain prefix.
PORT specifies the port that the service listens on, for example, 5060.
PRIORITY specifies the priority of the record. If there are multiple SRV records with the same service and protocol, the one with the lowest priority is used first. This field takes a positive whole number, such as 3.
WEIGHT determines which record to use if multiple SRV records exist with the same priority value. This field takes a positive whole number, such as 60. Records with higher numbers receive higher preference.

Setting a SRV record using DigitalOcean DNS looks like this:

In the example, the service uses SIP over UDP on port 5060 and directs the traffic to the subdomain sip.example.com, which hosts the service.

CAA Records

CAA records specify which certificate authorities are permitted to issue certificates for a domain. You can use them to reduce the risk of bad actors from creating unauthorized SSL/TLS certificates for your domain. See our detailed CAA record documentation for detailed information on how to use them.

PTR (rDNS) Records

PTR (pointer) records, also known as an rDNS (reverse DNS) records, map domains name to an IP address.

We automatically create PTR records for Droplets based on the name you give that Droplet in the control panel. The name must be a valid FQDN. For example, using example.com as the Droplet name creates a PTR record, but ubuntu-s-4vcpu-8gb-fra1-01 or my-droplet does not. Droplets with IPv6 enabled only have PTR records enabled for the first IPv6 address assigned to it, not to all 16 addresses available.

You cannot manually create PTR records through the DigitalOcean DNS interface.

How to Create, Edit, and Delete DNS Records

Time To Live (TTL) Guidance

Create, Update, or Delete Records Using the CLI

Create, Update, or Delete Records Using the API

cURL

Go

Ruby

Python

cURL

Python

cURL

Go

Ruby

Python

Create, Update, and Delete Records Using the Control Panel

Supported Record Types

A Records

AAAA Records

CNAME Records

MX Records

TXT Records

SPF Records

DKIM Record

NS Records

SRV Records

CAA Records

PTR (rDNS) Records

We can't find any results for your search.