Skip to content

Commit 22a5ada

Browse files
authored
Update custom-domain.md
Currently the information about the DNS records, their characteristics, and how to use them with web app, is scattered around the doc and requires digging various pages to understand it. I personally had a hard time understanding it. The information on this page, while good, but still needs enhancement. Also giving an example, can really help the readers. I suggest adding following for better clarity: "`CNAME` record maps a domain name to another domain (or subdomain) whereas `A` record maps a domain name to an IP address. If the IP address changes, a `CNAME` entry is still valid, unlike `A` record. Let’s say you have WebApp1 and you would like users to access it from https://www.contoso.com. You can do it in two possible ways: you can create a `CNAME` record and map it to WebApp1.azurestaticapps.net. Alternatively, you can create an `A` record and map it to the IP address of WebApp1."
1 parent 310126e commit 22a5ada

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

articles/static-web-apps/custom-domain.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ Setting up an apex domain is a common scenario to configure once your domain nam
3333

3434
Alternatively, for domain registrars that don't support `ALIAS` records, `ANAME` records or `CNAME` flattening, you can configure an `A` record for your static web app. This directs traffic to a single regional host of your static web app. Using `A` records is not recommended as your application will no longer benefit from its global distribution, and this may affect your application performance if your traffic is globally distributed.
3535

36+
> [!NOTE]
37+
> `CNAME` record maps a domain name to another domain (or subdomain) whereas `A` record maps a domain name to an IP address. If the IP address changes, a `CNAME` entry is still valid, unlike `A` record. Let’s say you have WebApp1 and you would like users to access it from https://www.contoso.com. You can do it in two possible ways: you can create a `CNAME` record and map it to WebApp1.azurestaticapps.net. Alternatively, you can create an `A` record and map it to the IP address of WebApp1.
38+
39+
3640
The following are terms you'll encounter as you set up a custom domain.
3741

3842
* **Apex or root domains**: Given the domain `www.example.com`, the `www` prefix is known as the subdomain, while the remaining segment of `example.com` is referred to as the apex domain.

0 commit comments

Comments
 (0)