How to point a domain to Azion

Point your domain record to your Azion domain, ensuring a seamless user experience with your application.

Important — We’re releasing a significant update to our platform. To learn more about the changes and required migration steps, see the API v4 rollout page.

If you already own a domain, you can associate your domain CNAME entries to your Azion Workload address effectively directing access to your application.

There are separate instructions for the legacy Domains settings and the new Workloads product.

Before you point your traffic to Azion, you can test your custom domain on the edge locally by staging your application through the hosts file.

This process will require you to associate a CNAME record to your domain. To associate an ANAME record to your application, migrate your nameservers to Azion.

In this guide, there are separate instructions for API v3 and API v4. If you’re not sure which steps apply to your account, see the Verify Your Account Migration guide to determine if your account has already been migrated.

Step 1: Verifying custom domain

To point your Azion domain to a custom domain, you need to list the CNAMEs you want to configure for the application:

Access Azion Console > Workloads.
Click the workload you want to associate your custom domain to.
In the Subdomain and Domain fields, add the custom domains for the application. For example: yourdomain.com.
Disable the the Workload Domain Allow Access switch.
Click the Save button.

Now your Azion Workload is ready to be associated to a custom domain on your DNS provider.

Access Azion Console > Domains.
Click the domain you want to associate your custom domain to.
In the CNAME field, add the custom domains for the application. For example: yourdomain.com.
Enable the CNAME Access Only switch.
Click the Save button.

Now your Azion domain is ready to be associated to a custom domain on your DNS provider.

Run the following GET request to retrieve your workload’s ID, replacing [TOKEN VALUE] with your personal token:

curl --request GET --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]'

You’ll receive a response similar to this:

{

"count": 3,

"results": [

{

"id": "<workload_id>",

"name": "My workload",

"active": true,

"last_editor": "your-email.example.com",

"last_modified": "2025-08-06T17:53:47.460211Z",

"infrastructure": 1,

"tls": {

"certificate": null,

"ciphers": 7,

"minimum_version": "tls_1_3"

},

"protocols": {

"http": {

"versions": [

"http1",

"http2"

],

"http_ports": [

80

],

"https_ports": [

443

],

"quic_ports": null

}

},

"mtls": {

"verification": null,

"certificate": null,

"crl": null

},

"domains": [

"xxxxxxx.azion.app"

],

"workload_domain_allow_access": false,

"workload_domain": "xxxxxxxx.map.azionedge.net",

"product_version": "1.0"

}

Locate the workload you wish to link to the custom domain and copy the workload_id value received in the response.
Run a PATCH request, , replacing [TOKEN VALUE] with your personal token and adding the workload_id as a path, to update the domains field with the domains you wish to configure:

curl --request PATCH --url https://api.azion.com/v4/workspace/workloads/<workload_id> --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"domains": [

"yourdomain.com",

"*.yourdomain.com"

]

}

Key	Description
`domains`	Accepts a list of CNAMEs values for the workload. For example, `[".yourdomain.com", ".yourdomain.org"]`.

If your application uses HTTPS, you might want to combine this process with the association of a digital certificate to your custom domain.

You should receive a response with the updated data.

Run the following GET request to retrieve your domain’s ID, replacing [TOKEN VALUE] with your personal token:

curl --location 'https://api.azionapi.net/domains?order_by=name&sort=asc&page=1&page_size=10' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'

You’ll receive a response similar to this:

{

...

"results": [

{

"id": <domain_id>,

"name": "yourdomain.com CA1 DC-yourdomain.com",

"cnames": [],

"cname_access_only": true,

"digital_certificate_id": <digital_certificate_id>,

"edge_application_id": <edge_application_id>,

"is_active": true,

"domain_name": "xxxxxxxxxx.map.azionedge.net"

}

]

}

Locate the domain you wish to link to the custom domain and copy the domain_id value received in the response.
Run a PATCH request, , replacing [TOKEN VALUE] with your personal token and adding the domain_id as a path, to update the cnames field with the domains you wish to configure:

curl --location --request PATCH 'https://api.azionapi.net/domains/<domain_id>' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"cnames": [

"yourdomain.com",

"*.yourdomain.com"

]

}

Key	Description
`cnames`	Accepts a list of CNAMEs for the domains as values. For example, `[".yourdomain.com", ".yourdomain.org"]`.

If your application uses HTTPS, you might want to combine this process with the association of a digital certificate to your custom domain.

You should receive a response with the updated data.

Step 2: Modifying domain records

Once you have a domain, you need to access your DNS provider and locate the records management area. There, you can modify every entry associated with your domain. The entry you need to associate your Azion domain to is a CNAME record.

Some services don’t allow you to change your ANAME resolution directly. You can point your custom ANAME record to your application by migrating your nameservers to Azion.

At your DNS provider, you can add or modify a www CNAME record and associate it to your application. See the documentation on how to edit domain records of some of the most popular DNS providers below:

To configure your DNS records:

Sign in to your DNS provider.
Choose your domain.
Locate the page where you can modify DNS records for your domain.
Create or edit the www CNAME record of your domain by filling out the information:

Name	Value	Type
`www`	`xxxxxxxxxx.map.azionedge.net`	CNAME

Some providers allow you to add a wildcard (*) subdomain instead of a specific subdomain to cover all scenarios. This way, you won’t need to specify that www.yourdomain.com and blog.yourdomain.com point to the same application address.

Don’t forget to save your settings.

Note that there might be a delay in propagation time when you access your application. If that’s the case, you can run the dig command in your terminal to check the DNS records of your edge node. For example:

dig +short yourdomain.org @200.0.0.0

Once the changes have propagated, you’ll be able to access your application through your custom domain.

Check the Azion API documentation to know more about all features available via API.