Edit

Set up an apex domain with Azure DNS in Azure Static Web Apps

  • Article

Domain names without a subdomain are known as apex or root domains. For example, the domain www.example.com is the www subdomain joined with the example.com apex domain.

This guide demonstrates how to use TXT and ALIAS records to configure your apex domain in Azure DNS.

The following procedure requires you to copy settings from an Azure DNS zone you create and your existing static web app. Consider opening the Azure portal in two different windows to make it easier to switch between the two services.

Validate domain ownership

  1. Open the Azure portal.

  2. Go to your static web app.

  3. Under Settings, select Custom domains.

  4. Select + Add, and then select Custom Domain on Azure DNS from the drop down menu.

  5. In the Enter domain tab, enter your apex domain name.

    For instance, if your domain name is example.com, enter example.com into this box (without any subdomains).

  6. Select Next.

  7. In the Validate + Configure tab, enter the following values.

    Setting Value
    Domain name This value should match the domain name you entered in the previous step.
    Hostname record type Select TXT.

  8. Select Generate code.

    Wait as the code is generated. It make take a minute or so to complete.

  9. Once the TXT record value is generated, copy (next to the generated value) the code to the clipboard.

  10. Select Close.

  11. Go to your Azure DNS zone instance.

  12. Select + Record set.

  13. Enter the following values in the Add record set window.

    Setting Property
    Name Enter @
    Type Select TXT - Text record type.
    TTL Keep default value.
    TTL unit Keep default value.
    Value Paste in the TXT record value in your clipboard from your static web app.

  14. Select OK.

  15. Return to your static web app in the Azure portal.

  16. Under Settings, select Custom domains.

Observe the Status for the row of your apex domain. Once the validation is complete, then your apex domain is publicly available.

While this validation is running, create an ALIAS record to finalize the configuration.

Set up ALIAS record

  1. Return to the Azure DNS zone in the Azure portal.

  2. Select + Record set.

  3. Enter the following values in the Add record set window.

    Setting Property
    Name Enter @
    Type Select A - Alias to IPv4 address
    Alias record set Select Yes.
    Alias type Select Azure resource
    Choose a subscription Select your Azure subscription.
    Azure resource Select the name of your static web app.
    TTL Keep default value.
    TTL unit Keep default value.

  4. Select OK.

  5. Open a new browser tab and go to your apex domain.

    After the DNS records are updated, you should see your static web app in the browser. Also, inspect the location to verify that your site is served securely using https.

Next steps

Manage the default domain