Conceptual

Working with DNS

Learn how DNS works in order to properly configure your domain.
Table of Contents

DNS is the system used to connect domain names to IP addresses. When you make a request for a website, the browser performs a DNS query. It's usually the recursive resolver that carries out this work, going to the root DNS nameserver, TLD nameserver, and the authoritative server, if it isn't found in the cache.

DNS configuration with multiple DNS record types
DNS configuration with multiple DNS record types

There are a number of different types of DNS records that can be used together to create a DNS configuration. Some of the common information that you might see in a DNS record are:

  • Host Name: The hostname of www
  • IP Address or URL: The IP address (or domain or in the case of a CNAME record), for example, 76.76.21.21 or vercel.com.
  • TTL (Time to live): The length of time the recursive server should keep a particular record in its cache. You should set this time based on how often people are visiting your site and how often your site may change. For more information, see the DNS propagation section.
  • Record Type: For example, CNAME. There are many different types of records, some of the most common are listed below.

To learn more about adding, verifying, and removing DNS records, see "Managing DNS records".

TypeDescription
AThis is used to translate domain names into IPv4 addresses. It is the most common type of DNS record.
AAAASimilar to A, but this is used to translate domain names into IPv6 addresses. IPv6 is not supported on Vercel. See IPv6 support for more information.
ALIASThis is used to map a domain name to another domain name. It is similar to a CNAME record, but can only be used at the zone apex. The target domain must return A or AAAA record.
CAAThis is used to specify which certificate authorities are allowed to issue certificates for a domain. Vercel automatically adds a CAA record for Let's Encrypt at the zone apex.
CNAMEThis is used to specify that the domain name is an alias for another domain name. It cannot be used at the zone apex. See Working with Apex domain for more information.
HTTPSThis is used to achieve a CNAME-like functionality, but can be used at the zone apex. This is designed specifically for HTTP protocol to improve client performance in establishing secure connections. The record includes additional information about the target server, such as supported ALPN protocols (e.g., HTTP/2, HTTP/3, etc). This is a fairly new record type, and not all clients can support. See RFC 9460 for more details.
MXThis is used to specify the mail server for the domain.
NSThis is used to specify the authoritative name server for the domain.
TXTThis is used to provide information about the domain in text format. Commonly used for verification purposes.
SRVThis is used to specify the location of the service. The record contains priority, weight, port, target, and other information.

When you're configuring or making changes to your DNS settings, you should be aware that it doesn't happen instantaneously. There's a whole network of servers, each of which has their own cache, and each of these will need to be updated to any new values that you set. For this reason, it can be normal to take up to 24-48 hours to see changes fully propagate through the network.

As we described earlier, when you set a record, you normally set a TTL value, or Time to Live, on a DNS record. This value, set in seconds, is the length of time a DNS cache will store information about your site, before it requests a new copy of the record from the authoritative server.

When you set the TTL value in your DNS record, you need to find the balance between serving your users the site quickly, and ensuring they're not seeing outdated information. A short TTL (minimum 30s) is beneficial if you are constantly updating the content, but will cause slower load times for your site. Using a longer TTL (max 86400 seconds, or 24 hours) means that records are cached for longer, so the site can load quickly for your users. Vercel defaults to 60s for a DNS record.

When you are transferring an existing (in-use) domain to Vercel, it's a good practice to check the existing DNS record and its TTL before switching. Ideally, about 24 hours in advance of changes, you should shorten the DNS TTL to 60s. Once it's propagated, you can then change the DNS record to Vercel so that traffic quickly moves over to the new site because now the DNS TTL is much shorter.

You can use tools such as https://www.whatsmydns.net to determine if your DNS settings have been fully propagated.

To learn more about common DNS issues, see the troubleshooting doc.

Last updated on October 4, 2024