---
title: "Manage user domains"
sidebar_label: "Manage user domains"
description: "How to manage user domains: add domains from Selectel DNS hosting and external DNS providers, disable, and delete domains"
sidebar_position: 3
---

import Formbricks from '@theme/MDXComponents/Formbricks'
import TrashIcon from '@selectel/docux/icons/trash'
import UserDomains from '@site/i18n/en/docusaurus-plugin-content-docs/current/_partials/s3/user-domains.mdx'

# Manage user domains

<UserDomains />

## Add a user domain from Selectel DNS hosting \{#add-selectel-dns-domain}

You can add a domain to an existing DNS hosting zone that is delegated to Selectel DNS hosting, or create a new zone while adding the domain.

After adding a domain, a resource record for S3 integration (CNAME record) will be automatically created, pointing to the public bucket domain. A domain can only have one CNAME record. If you already have a CNAME record, it will be used, and no duplicate record will be created.

If the automatically created CNAME record conflicts with other records, you will need to resolve the conflict yourself in your DNS hosting.

1. Optional: [create a new DNS hosting zone](#create-new-domain-zone).
2. [Add the domain to the bucket](#add-domain-to-bucket).
3. [Add a TLS (SSL) certificate](#add-tls-certificate).

### 1. Optionally: create a new DNS zone \{#create-new-domain-zone}

1. In the [control panel](https://my.selectel.ru/storage/), on the top menu, click **Products** and select **S3**.
2. Go to the **Buckets** section.
3. Open the bucket page → **Domains** tab.
4. In the **Custom domains** row, click **Add**.
5. In the **Domain binding** block, in the **Zone** field, select **New DNS zone**.
6. Enter the name of the DNS zone that is the parent for your domain. For example, if you are binding the domain `first.example.com`, the DNS zone will be `example.com`.
7. Click **Add**.
8. [Delegate the domain](/dns-hosting/zones/delegate-zone.mdx).

### 2. Add the domain to the bucket \{#add-domain-to-bucket}

1. Ensure that you have [created a DNS zone](/dns-hosting/zones/create-zone.mdx) and [delegated the domain](/dns-hosting/zones/delegate-zone.mdx).
2. In the [control panel](https://my.selectel.ru/storage/), on the top menu, click **Products** and select **S3**.
3. Go to the **Buckets** section.
4. In the [control panel](https://my.selectel.ru/storage/), go to **S3** → **Buckets**.
5. Open the bucket page → **Domains** tab.
6. In the **Custom domains** row, click **Add**.
7. In the **Domain binding** block:

   7.1. In the **Zone** field, select a DNS zone.

   7.2. In the **Bucket address** field, enter a subdomain in the DNS zone.

   7.3. Click **Bind**.

### 3. Add a TLS (SSL) certificate \{#add-tls-certificate}

Use the [TLS (SSL) Certificates for Custom Domains](/s3/manage/tls-ssl-certificates.mdx) guide.

## Add a user domain from external DNS hosting \{#add-external-dns-user-domain}

1. Open the control panel of your DNS hosting.

2. Create a DNS record and specify:

   * record type — `CNAME`;
   * record name — the user domain;
   * value — [the domain for DNS records](/s3/manage/domains.mdx#dns-domains), depends on the [pool](/infrastructure/locations.mdx#pool) where S3 is located.

   A domain can have only one CNAME record.

3. In the [control panel](https://my.selectel.ru/storage/), on the top menu, click **Products** and select **S3**.

4. Go to the **Buckets** section.

5. Open the bucket page → **Domains** tab.

6. In the **Custom domains** row, click **Add**.

7. In the **Domain binding** block:

   7.1. In the **Zone** field, select **DNS zone from another DNS hosting**.

   7.2. In the **Bucket address** field, enter the user domain.

   7.3. Click **Bind**.

8. [Add a TLS (SSL) certificate](/s3/manage/tls-ssl-certificates.mdx).

## Disable a user domain \{#disable-user-domain}

The user domain is disabled when the bucket type is changed to private or when the [domain is deleted](#delete-user-domain).

## Delete a user domain \{#delete-user-domain}

1. In the [control panel](https://my.selectel.ru/storage/), on the top menu, click **Products** and select **S3**.
2. Go to the **Buckets** section.
3. Open the bucket page → **Domains** tab.
4. In the domain row, click <TrashIcon />.

<Formbricks />