> ## Documentation Index
> Fetch the complete documentation index at: https://alguna.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Domains

> Custom domains allow you to personalize how your users access your hosted pages.

By default, Alguna serves your hosted pages on a subdomain that is based on the organization slug you have configured in your settings. For example:

```
https://waystar.alguna.app/checkout/TZbLkouDnbbPtJhPWC1...
```

Adding a custom domain allows you to keep a consistent experience for your customers by keeping them on your domain. For example:

```
https://buy.waystar.com/checkout/TZbLkouDnbbPtJhPWC1...
```

## Adding a custom domain

To point your custom domain to our service, you need to add a CNAME record in your DNS provider's settings pointing to `domains.alguna.io`, where `<subdomain>` is replaced
by your desired subdomain.

| Type  | Host          | Value               | TTL     |
| ----- | ------------- | ------------------- | ------- |
| CNAME | `<subdomain>` | `domains.alguna.io` | 30 mins |

We recommend setting a TTL (Time-To-Live) of 30 minutes for the CNAME record.

<Warning>
  Ensure you do not have conflicting records (like A records) for the same
  subdomains.
</Warning>

**Example**

Following the example above, for `buy.waystar.com` we'd add a CNAME record for `buy` on `waystar.com`

| Type  | Host  | Value               | TTL     |
| ----- | ----- | ------------------- | ------- |
| CNAME | `buy` | `domains.alguna.io` | 30 mins |

## Share the custom domain

Once that's done, you can share the custom domain with Alguna. We will now set up your domain and issue SSL certificates to serve traffic through.
