## Create data domains

URL: https://docs.atlan.com/product/capabilities/data-products/how-tos/create-data-domains

> Data domains provide a logical way of grouping data products within a specific domain or business entity - for example, functions like finance and sales, business units for different products and services, regions of operation, and more. Most importantly, data domains help in fostering collaboration and promote shared ownership and domain-level governance in your organization.

:::info **Did you know?** 
Some capabilities shown here may require additional enablement or licensing. Contact your Atlan representative for details.
:::

:::warning Who can do this?
 Before you can create a data domain, you need your Atlan admin to [enable the products module in your Atlan workspace](https://docs.atlan.com/llms/governance/data-products/what-are-data-products/llms.txt). Once enabled, first review the [order of operations](https://docs.atlan.com/llms/governance/data-products/what-are-data-products/llms.txt). You need to be a [domain owner or domain admin in Atlan](https://docs.atlan.com/llms/governance/data-products/what-are-data-products/llms.txt) or have access through [domain policies](https://docs.atlan.com/llms/governance/data-products/create-domain-policies/llms.txt) to create and manage data domains. If you don't wish to enable the products module but still want to create domains in Atlan, refer to [How to manage domains](https://docs.atlan.com/llms/governance/domains/manage-domains/llms.txt) instead.

:::

Data domains provide a logical way of grouping data products within a specific domain or business entity - for example, functions like finance and sales, business units for different products and services, regions of operation, and more. Most importantly, data domains help in fostering collaboration and promote shared ownership and domain-level governance in your organization.

Data domains in Atlan take true meaning from:

- Key stakeholders of a specific domain and their roles
- Data products within that specific domain

## Create a data domain

To create a data domain:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. On the _Products_ page, click **Get started**.
3. For _Overview_, enter the basic details for your domain:
 1. (Optional) For _Cover_, click the **Change** button to select an image from the gallery or upload an image of your own. Click **Reposition** to drag and reposition the cover image and then click **Save position** to save your preferences.
 2. (Optional) For _Theme_, choose from the available color options to add a theme to your domain.
 3. For _Name_, enter a meaningful name for your data domain - for example, `Customer Service`. The character limit for a domain name is 80 characters.
 4. (Optional) Click the domain icon to change the icon for your domain.
 5. (Optional) For _Description_, enter a description for your domain.
 6. For _Owners_, assign additional users or groups as domain owner.
4. In the top right of the screen, click the **Create** button to complete setup.

Congrats on creating your data domain in Atlan! 🎉

## (Optional) Create a data subdomain

:::warning

You need to create a data domain before you can add a data subdomain to it.

:::

Data subdomains help you logically segment your data domains according to business needs.

To create a data subdomain:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. To select a domain or subdomain, you can either:
 - From the navigation menu on the _Products_ homepage, use the search bar or select the relevant domain or subdomain.
 - From the top right of _Discover domains_, select your data domain of interest. If you cannot find your data domain, click the **View all** button to view more domains.
3. In the upper right of your data domain page, click the **\+ Add button** and then click **New sub-domain** to add a data subdomain.
4. For _Overview_, enter the basic details for your subdomain: 
 1. (Optional) For _Cover_, click the **Change** button to select an image from the gallery or upload an image of your own. Click **Reposition** to drag and reposition the cover image and then click **Save position** to save your preferences.
 2. (Optional) For _Theme_, choose from the available color options to add a theme to your subdomain.
 3. For _Name_, enter a meaningful name for your subdomain - for example, `Social Media`. The character limit for a subdomain name is 80 characters.
 4. (Optional) Click the domain icon to change the icon for your subdomain.
 5. (Optional) For _Description_, enter a description for your subdomain.
 6. For _Owners_, assign additional users or groups as subdomain owner.
5. In the top right of the screen, click the **Create** button to complete setup.

Congrats on creating your data subdomain in Atlan! 🎉

Your data producers can now [add data products](https://docs.atlan.com/llms/governance/data-products/create-data-products/llms.txt) to your data domain.

## Update a data domain

The domain profile includes essential details about the data domain. You can also curate what domain users can view.

To update a data domain:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. To select a domain or subdomain, you can either:
 - From the navigation menu on the _Products_ homepage, use the search bar or select the relevant domain or subdomain.
 - From the top right of _Discover domains_, select your data domain of interest. If you cannot find your data domain, click the **View all** button to view more domains.
3. On your data domain page, the _Overview_ tab displays important details about the domain. (Optional) From the top right, click the **\+ Add** button and then:
 - Click **New sub-domain** to add data subdomains.
 - Click **New product** to add data products.

 :::warning

 Even as a domain owner or admin, you need to have [create, update, and delete permissions through domain policies](https://docs.atlan.com/llms/governance/data-products/create-domain-policies/llms.txt) for a specific domain or subdomain to create and manage data products.

 :::

4. Under _Summary_, view a total count of data products in your domain and domain description:
 - (Optional) Click **\+ Add stakeholder** to [add stakeholders](https://docs.atlan.com/llms/governance/data-products/add-stakeholders/llms.txt).
 - (Optional) Click the _Description_ field to update the description.
 - (Optional) For _Owners_, click the pencil icon to add or remove [owners](https://docs.atlan.com/llms/catalog/discovery/add-owners/llms.txt).
 - (Optional) If [custom metadata properties](https://docs.atlan.com/llms/governance/custom-metadata/manage-custom-metadata-structures/llms.txt) are available, you can add [custom metadata](https://docs.atlan.com/llms/catalog/discovery/add-custom-metadata/llms.txt) to your domain.
 - (Optional) Click **\+ Add resource** to [add a resource](https://docs.atlan.com/llms/catalog/discovery/add-a-resource/llms.txt) to your domain.
5. Under _Readme_, click **\+ Add** to [add a README](https://docs.atlan.com/llms/governance/integrations/llms.txt) to your data domain or [use Atlan AI for documentation](https://docs.atlan.com/llms/governance/atlan-ai/use-atlan-ai-for-documentation/llms.txt).
6. From the top right of the data domain profile:
 - Click the user avatars to view a list of recently visited users, total views on your domain, total number of unique visitors, and total views by user.
 - Use the days filter to filter domain views and user activity in the last 7, 30, and 90 days.
 - This feature is turned on by default - admins can [turn off user activity](https://docs.atlan.com/llms/governance/administration/disable-user-activity/llms.txt).
 - Click the star button to [star your domain](https://docs.atlan.com/llms/catalog/discovery/star-assets/llms.txt) and bookmark it for easy access.
 - Click the **Slack** or **Teams** icon to post on a [Slack](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt) or [Microsoft Teams](https://docs.atlan.com/llms/governance/integrations/integrate-microsoft-teams/llms.txt) channel.
 - Click the 3-dot icon to [add an announcement](https://docs.atlan.com/llms/governance/integrations/create-announcements/llms.txt) or a [resource](https://docs.atlan.com/llms/catalog/discovery/add-a-resource/llms.txt) to your domain.
7. Switch to the **Products** tab to view [data products](https://docs.atlan.com/llms/governance/data-products/create-data-products/llms.txt) within your domain.
8. Switch to the **Statistics** tab to [monitor domain usage](https://docs.atlan.com/llms/governance/data-products/monitor-data-domains/llms.txt).
9. Switch to the **Lineage** tab to view [business lineage for your domain](https://docs.atlan.com/llms/governance/data-products/what-is-business-lineage/llms.txt).

## Move a subdomain or product

You can move subdomains and products within and across domains to better organize your business entity. Move data products to a different subdomain or domain, or create subdomains within the same domain or across your domains in Atlan.

You need the following permissions:

- Moving a subdomain or product from one domain to another - [_Update Domains_ permission](https://docs.atlan.com/llms/governance/data-products/create-domain-policies/llms.txt) on both the source and target domains.
- Moving a subdomain or product within the same domain - [_Update Domains_ permission](https://docs.atlan.com/llms/governance/data-products/create-domain-policies/llms.txt) on the domain you want to reorganize.

To move an existing subdomain or product:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. In the left menu of the _Products_ page, you can either:
 - Drag and drop a subdomain or product into the relevant domain within the same or a different parent domain. In the popup, click **Move** to confirm the changes.
 - To the right of the subdomain or product name, click the three dots icon and then click **Move to**. In the _Move to_ dialog, select a relevant parent domain within the same or a different domain and then click **Move** to confirm the changes.

## Convert a subdomain to a domain

You can convert subdomains into parent domains. For example, as your organization grows, some small teams may evolve into major departments. In that case, you may want your subdomains in Atlan to better reflect your organizational architecture and convert them to domains.

You need the [_Update Domains_ permission](https://docs.atlan.com/llms/governance/data-products/create-domain-policies/llms.txt) on the subdomain and parent domain of the subdomain you want to convert.

To convert a subdomain into a domain:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. In the left menu of the _Products_ page, to the right of the subdomain you want to convert, click the three dots icon and then click **Convert to domain**.
3. In the _Convert to domain_ dialog, click **Convert to domain** to confirm your changes.

## Archive a data domain

You can archive your data domains and subdomains when they are no longer in use. Note that Atlan does not allow archiving a domain that contains any active subdomains or products. Ensure that your domain content is inactive before you proceed.

To archive a data domain:

1. From the left sidebar, click on **all assets** and then click on Domains & Products.
 * If you are using the **Old UI (Classic)**, from the left menu of any screen in Atlan, click **Products**.
2. To select a domain or subdomain to archive, you can either:
 - From the navigation menu on the _Products_ homepage, use the search bar or select the relevant domain or subdomain.
 - From the top right of _Discover domains_, select your data domain of interest. If you cannot find your data domain, click the **View all** button to view more domains.
3. From the top right of the domain or subdomain profile, click the 3-dot icon and then click **Archive**.
4. From the _Archive domain?_ dialog, click **Archive** to archive your data domain.

:::info **Did you know?** 
 To programmatically create, update, and manage data domains using API, refer to the [developer documentation](https://docs.atlan.com/llms/governance/domains/manage-data-domains/llms.txt).

:::

---