---
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-07-08T17:53:56Z
published: 2026-07-08T17:53:56Z
canonical: "docs.wasabi.com/custom-domains"
---

> ## 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.
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. The selected region is displayed.

In the next field, enter the custom **Domain** name.

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

Once you enter a domain, the DNS records to create are displayed. You can click ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-GVUKJ5TO.png) to copy a record.

Add the CNAME records to your DNS provider. Note that changes may take some time.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-OLUZVBLA.png)
6. You can provide a redirect URL to use when the custom domain is entered in a browser. To do so, enter a URL in the **Redirect URL** field.
7. Once you have created a CNAME record, confirm by clicking the down-down and selecting **Yes**.
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-C30UDZNS.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. (Note that the URLs used in the example do not match those in the screens shown above.)

#### 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 5, enter your custom URL: s3.us-west-1.my-domain-name.com
3. Optionally, in Step 6, 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)