---
title: "Custom Domain: Adding"
slug: "custom-domains"
description: "The Custom Domains feature is available only for resellers and control accounts. You can add a custom domain for S3 endpoints, such as for white label functionality and management of SSL certificates."
updated: 2026-05-08T21:40:50Z
published: 2026-05-08T21:40:50Z
---

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

# Custom Domain: Adding

You can use the Custom Domain feature to add a custom domain for S3 endpoints, such as for white label functionality and management of SSL certificates. This feature is available only for resellers and control accounts.

## Adding a Domain

1. Click **Settings**on the Wasabi menu. Or, open the account sign-in ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1697644604764.png) drop-down and click **Settings**.
2. Open the **Custom Domain**drop-down.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1719412766027.png)
3. Click **Add Domain**.
4. Select a region for the domain.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1719411599477.png)
5. Review the displayed information about creating a CNAME record. (Note that you can click ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-T2EWR7DC.png) to copy the CNAME.) Once you have created a CNAME record, click the down-down and select **Yes**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-SIXW65L7.png)
6. Enter the custom **Domain**name.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-GPJ73AH9.png)
7. Notice that you have an option to provide a redirect URL to be used when the custom domain is entered in a browser.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-7KZBB1TF.png)
8. Click **Submit**. The domain will move into a pending state and, after about 5-10 minutes, you should receive an email indicating your domain setup completed successfully (or failed).

The new domain information is displayed. For example:

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1719413076537.png)

## Example of Setting Up Your Custom Domain

The following example will walk you through configuring DNS records for your custom domain to work with Wasabi storage.

#### What You Will Need

For this example, you will set up the domain:

s3.us-west-1.my-domain-name.com

You will need to create three DNS records in your domain's DNS settings:

- 1 CNAME record for ACME challenge (for SSL certificate verification)
- 1 CNAME record for the root domain
- 1 CNAME wildcard record

#### Step 1: Configure Your DNS Records

Log in to your DNS provider and add the following three CNAME records.

> Replace us-west-1 with your preferred Wasabi region (such as us-east-1 , eu-central-1 , or ap-southeast-1 ).

- Record 1: ACME Challenge (for SSL verification)
  - Type: CNAME
  - Name: _acme-challenge.s3.us-west-1.my-domain-name.com
  - Value: _acme-challenge.verify.wasabisys.com
- Record 2: Root Domain (for path-based access)
  - Type: CNAME
  - Name: s3.us-west-1.my-domain-name.com
  - Value: s3.us-west-1.wasabisys.com
- Record 3: Wildcard (for virtual host-based access)
  - Type: CNAME
  - Name: *.s3.us-west-1.my-domain-name.com
  - Value: s3.us-west-1.wasabisys.com

#### Step 2: Add Your Domain

After setting up your DNS records, you can add the domain through the Wasabi Console:

1. Follow the instructions in the *Adding a Domain section* above.
2. In Step 6, enter your custom URL: s3.us-west-1.my-domain-name.com
3. Optionally, in Step 7, you can add a redirect URL to point to your main website (such as https://my-domain-name.co).

#### DNS Propagation

Note that DNS changes can take anywhere from a few minutes to 48 hours to fully propagate across the internet.

## Deleting a Custom Domain

1. On the Custom Domain list, click ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1719413318540.png) for the domain you want to delete.
2. Confirm by clicking **Delete**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1719413392989.png)