# Connecting Your Domain

This document covers how to connect a domain to Airkit and white label a web url. In order to connect a domain to Airkit, there are a few configuration steps needed.

### \[block:callout] { "type": "warning", "body": "If using a custom domain in an application, whether it is a URL Domain or URL Route, that domain has to be compatible with [https://letsencrypt.org/docs/certificate-compatibility/](https://letsencrypt.org/docs/certificate-compatibility/)." } \[/block] Create a CNAME record in your domain provider

Create a CNAME record for the domain with the following values:

usher.woodsidebikes.com -> app.airkit.com.

\[block:callout] { "type": "info", "body": "The domain must be pointing to app.airkit.com first and propagated before moving on to the next step. Also, based on the realm of the Airkit organization, the url will differ:\n\n\n\n**US Realm:** `\napp.airkit.com` **EU Realm:** `\napp.airkit.eu` **APAC Realm:** `\napp.airkit.com.au`" } \[/block] The below is an example configuration for a domain hosted in Amazon AWS:

![organizing info](https://1191388742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhOn9CLWoV9VfJeM5EDAa%2Fuploads%2Fgit-blob-cab7b92642b52de07b6a8fb7c7712dd5fe0cab2c%2Fconnecting-your-domain-v1715-0.png?alt=media)

### Creating a URL domain and URL Route

To add a URL Domain and a URL Route in Airkit, go to [console.airkit.com](https://console.airkit.com) to add a resource.&#x20;

To add a URL domain, under **Resources** click on **+New** and type a unique name to label the domain and select URL Domain in the capabilities drop down.

![organizing info](https://1191388742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhOn9CLWoV9VfJeM5EDAa%2Fuploads%2Fgit-blob-1b049ba4fb02ae8d2958cfb42343712a86bbeebc%2Fconnecting-your-domain-v1715-1.png?alt=media)

After selecting URL Domain, put in the custom domain name that was created when the CNAME was created. For example: usher.woodsidebikes.com. Airkit will then attempt to retrieve the certificate that was created.  The URL Domain will then be able to be used for canvas links and web launch URLs.

After adding a URL domain, add a URL Route resource. Under the **Resources** tab, Click on **+New** and type a unique name to label the route and select URL Route in the capabilities drop down.

![](https://github.com/airkit/airkit-docs/blob/master/docs/v17-15/assets/connecting-your-domain-v1715-2.42%20PM%20\(1\).png)

Then select the URL domain that was created in the previous step. This will provide the ability to create a custom path on your domain (e.g. usher.woodsidebikes.com/c/order).&#x20;

Lastly, add a Custom URL key which give the ability to customize the URL the app will launch at.

### Configure the domain in configuration builder

Go to **Configuration Builder** and look for Web Resource. This is where to configure what domain the application is hosted on. Find the URL Route that was created and select that URL Route as the web resource.&#x20;

![](https://1191388742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhOn9CLWoV9VfJeM5EDAa%2Fuploads%2Fgit-blob-6cc3646cec773dc86019da6a1c4d006775f5799d%2Fconnecting-your-domain-v1715-3.png?alt=media)

Once published, the application will now use the white-labeled domain!

### Further Reading

White labeling a domain provides a more branded experience for an application. Instead of users seeing app.airkit.com when sent a link, they will see a custom domain. For related information on publishing your application or connecting Twilio numbers, see below:

* [Publishing Your Application](../building-apps/publishing/publishing-your-application)
* [Connecting Your Twilio Numbers to Airkit](connecting-twilio-numbers)
* [Using Profiles for Deployment settings and Configurations](../building-apps/publishing/profiles-and-deployment-settings)
