Discover page, domains, and subdomains

Important

This feature is in Beta.

The Discover page is a curated browsing experience for your organization to discover data assets and insights in Azure Databricks. Discover has an intuitive interface that showcases your assets and insights without requiring deep technical knowledge of catalog hierarchies. Use domains and subdomains in the discovery experience to logically organize data in a way that's best suited for your business.

Warning

Domains are built on tags. Tag data is stored as plain text and is replicated globally. Do not use tag names, values, or descriptors that can compromise the security of your resources. For example, do not use tag names, values, or descriptors that contain personal or sensitive information.

Domain metadata is replicated globally. Do not use domain IDs, descriptions, subtitles, or other metadata that can compromise the security of your resources. For example, do not use domain IDs, descriptions, or subtitles that contain personal or sensitive information.

Roles

• Curators: Create and manage domains, assign assets to them, customize the Discover page and domain pages, and enable others in your organization to browse data by business purpose in the Discover page. As a curator, you can organize and highlight the most valuable assets for your organization. See Steps for curators.
• Consumers: Use the Discover page to find curated assets organized by domain or asset type, and explore AI-recommended assets that might be useful. See Steps for consumers.

What is Databricks Discover?

Databricks Discover is a centralized discovery page that enables:

• Browse by domains, a business-aligned organization layer where you can organize data assets (for example, tables, dashboards, and Genie Spaces) to meet business needs.
• Custom curation capabilities where curators can customize and highlight specific assets in their organization or domain.
• AI-powered recommendations to surface popular and valuable datasets to enable curation at scale.
• Unified discovery experience across tables, dashboards, queries, notebooks, and more.

What are domains?

Domains are an organization layer that groups data products and assets by governed tags. Domains help users find data that relates to their needs more easily. To add an asset to a domain, add the corresponding governed tag to the asset. Large domains can be further divided into subdomains to partition assets by more specific business areas.

What are subdomains?

A subdomain is a second level of hierarchy within a domain. Subdomains let you partition a large domain (for example, Finance) into more specific business areas (for example, Audit, Tax, or FP&A) without creating additional top-level domains.

• One level of nesting. A domain can contain many subdomains, but subdomains cannot contain their own subdomains.
• One parent per subdomain. Each subdomain belongs to exactly one parent domain.
• Many-to-many for assets. An asset can belong to multiple domains and subdomains.
• Subdomain assets appear in the parent domain. Subdomains filter assets within their parent domain — they do not hide assets from it.
• Built on governed tags with a shared prefix. Subdomains use a {parentDomainTag}/{subdomainName} naming convention (for example, Finance/Tax). The parent domain tag is a separate tag from the subdomain tag: tagging an asset with Finance/Tax does not automatically tag it with Finance.

Enable or disable the Discover page and domains

Note

Domains are an account-level concept that utilize governed tags. Domains that you configure apply to the whole account, not select workspaces.

To enable the Discover page with domains, an account admin must enable both of the following previews:

• Domains and Discover Page: Enabled per account.
• Discover Page: Enabled per workspace.

See Manage Azure Databricks previews.

Access the Discover page

In the sidebar, click Discover to access the Discover page.

Steps for curators

The Discover page with domains is a powerful tool to shape how other users in your organization can browse and discover key assets. Domains let consumers browse data in a way that's aligned with how they understand your business within your organization. Each domain page also allows curators to create custom collections on that page to further guide and emphasize the best assets in that domain.

Important

You must have the MANAGE DISCOVERY permission to customize the Discover page and manage domains. Account admins and workspace admins have this permission by default. Account admins can grant the permission to other users.

Create a domain

Domains are built on governed tags. To create a domain, you can either map it to an existing tag or create a governed tag with the same name. For example, to create a "Marketing" domain, you must create a "Marketing" governed tag.

Note

Tags that contain a slash (/) cannot be used to create a top-level domain. The slash is reserved for the subdomain naming convention. See Create a subdomain.

1. In the top-right corner of the Discover page, click Create domain.

   

2. In the Create domain modal, select an existing governed tag or create a new one, then fill out the following fields:

   • Subtitle: Appears on the domain card.
   • Description: The domain overview.
   • Technical owner (optional): Who is responsible for technical aspects of the domain.
   • Business owner (optional): Who is responsible for business aspects of the domain.

   

3. Click Create to create the domain and add a corresponding draft domain card on the Discover page.

   When you create a domain, it is in the draft state. The draft state is indicated by an icon next to the title. Draft domains are only visible to users with the MANAGE DISCOVERY permission.

4. Optionally, click Edit Sections to add assets and customize the domain layout.

5. To make the domain available to consumers, click Edit Sections on the domain page, then click Publish. After publishing, users can use the domain as a filter in the search experience.

Create a subdomain

Subdomains are built on the same governed-tag primitive as domains, but follow a required {parentDomainTag}/{subdomainName} naming pattern.

1. On the Discover page, open the parent domain page.

2. Click Create subdomain in the top-right corner.

3. In the Create subdomain modal, select one of:

   • Create a tag: Enter the name you want to give your subdomain. Azure Databricks automatically prefixes the new tag with the parent domain's tag key (for example, entering Tax under the Finance domain creates the tag Finance/Tax). The subdomain name itself cannot contain a slash (/); subdomains support only one level of nesting.
   • Use an existing tag: Select a governed tag that already matches the {parentDomainTag}/... pattern. The picker only shows tags that share the parent's prefix. A tag that is already designated as a domain or a subdomain cannot be reused.

   

4. Optionally, fill out the subdomain fields:

   • Subtitle: Appears on the subdomain card.
   • Description: The subdomain overview.
   • Technical owner: Can differ from the parent domain's technical owner.
   • Business owner: Can differ from the parent domain's business owner.

5. Click Create to create the subdomain in a draft state.

6. To make the subdomain available to consumers, click Edit Sections on the subdomain page, then click Publish.

Edit a domain or subdomain

1. On the Discover page, click the overflow menu and select Manage Domains.
2. For the domain or subdomain you'd like to edit, click the kebab menu on the right.
3. Click Edit domain.

Delete a domain or subdomain

1. On the Discover page, click the overflow menu and select Manage Domains.
2. For the domain or subdomain you'd like to delete, click the kebab menu on the right.
3. Click Remove domain.

Assign assets to a domain

There are multiple ways to add assets to a domain:

• Add them directly from the domain page.
• Apply the corresponding governed tag to the assets.

From the domain page

1. Go to the Discover page and click the domain you want to add assets to.
2. Click Add to Domain on the top right. You must have the permission to add the associated tag to the asset you are attempting to add to the domain.
3. In the Asset Selector modal, select the asset you would like to add to the domain and click Add.
   • The Asset Selector allows you to browse and search for assets across your workspace and catalog.
   • Depending on the type of assets you want to add, you can switch between Workspace (for assets like dashboards and Genie Spaces) and Catalog (for assets like tables and metric views).
   • You can add one asset to a domain at a time.
4. If successfully added, the asset is displayed in the Recently Added section.

By tagging assets

To assign an asset (for example, a catalog, schema, table, or dashboard) to a domain, you can also tag it with the governed tag that matches the domain. You can apply tags to tables, dashboards, and Genie Spaces. See Apply tags to Unity Catalog securable objects.

Assign assets to a subdomain

Assigning assets to a subdomain works the same way as assigning to a domain, but uses the subdomain's tag.

• From the subdomain page: Open the subdomain page and click Add to Domain. You must have permission to apply the subdomain tag to the asset.
• By tagging assets: Apply the subdomain's governed tag (for example, Finance/Tax) to the asset.

Because the parent domain tag and the subdomain tag are independent tags, tagging an asset with Finance/Tax does not automatically tag it with Finance. However, assets in a subdomain still appear in the parent domain's browse and search results.

Customize the Discover page, domain, and subdomain layouts

Warning

Custom section data is replicated globally. Do not use titles, subtitles, or other metadata that could compromise the security of your resources. For example, do not use titles or subtitles that contain personal or sensitive information.

1. Click Edit Sections at the top-right of the Discover page, any domain page, or any subdomain page. This takes you to a draft state of the page where you can customize existing sections, create custom sections, delete custom sections, hide default sections, and reorder sections on the page.

2. To create a new section, click the + Section divider.

3. In the Create section modal, add a Title and a Subtitle, then select how to define the section's assets:

   • Search query: The section auto-fills with assets matching the search query you define. Results are ranked automatically based on relevance and usage signals; you can pin specific assets to elevate them to the top. See Pin or reorder assets in a section.
   • Manually selected: Select a fixed set of assets and order them yourself. See Pin or reorder assets in a section.

   Users browsing the domain or Discover page must have either the BROWSE or VIEW permission to see the items in the section.

1. Click Save, then click Publish to update the current Discover page, domain, or subdomain layout for your organization.

For a subdomain card to appear on its parent domain page, the parent must also be republished — open the parent domain, click Edit Sections, then Publish.

Pin or reorder assets in a section

How asset order works in a section depends on the section type. In a manually-selected section, you reorder the assets you've chosen. In a search-query section, you pin specific assets to elevate them above the auto-ranked results.

Reorder assets in a manually-selected section

In a manually-selected section, you select every asset that appears and define the order yourself.

1. Open the manually-selected section in edit mode, or create one.

2. In the section's edit modal, use the up and down chevrons next to each selected asset to define the order they appear in.

   

3. Click Save (or Save as draft), then Publish to make the section visible to consumers.

Pin assets in a search-query section

In a search-query section, assets are auto-selected by your query and ranked automatically. You can pin specific assets so they appear at the top, ahead of the auto-ranked results.

1. Open the search-query section in edit mode, or create one.

2. In the section's edit modal, you see all the assets matching the search query. On the asset card you want to pin, click the pin button in the bottom-right corner. The asset moves to the top of the section's results.

   

3. Click Save, then Publish.

Manage discovery permissions

Account admins can grant users the MANAGE DISCOVERY permission so they can customize the Discover page and manage domains.

1. On the Discover page, click the overflow menu and select Manage Domains.
2. Click the Permissions tab.
3. Click Grant Permissions to grant the permission to the corresponding principal.

Steps for consumers

Browse by domain

Click a card under Browse by domain.

You can now see the assets in the domain.

Browse by subdomain

If a domain has subdomains, a Subdomains section appears on the domain page. Click a subdomain card to filter the domain's assets down to that subdomain. Assets in a subdomain also appear on the parent domain page. Subdomains narrow the view; they do not hide assets from the parent.

In global search, the Domain filter includes both domains and subdomains, so you can scope results to a specific subdomain the same way you scope to a domain. When search results include an asset that belongs to a subdomain, the asset's domain and subdomain membership is shown on the result.

Browse by asset type

On the Discover page, scroll down to view different sections by asset type, such as Dashboards and Tables.

Click View all under any asset type to browse all assets of that type, including Certified assets and Assets suggested by AI.

Limitations

• For the limit on the total number of domains and subdomains you can create per account (combined), see Resource limits.
• For limitations on the number of tags you can apply, see Resource limits.
• Subdomains support only one level of nesting. A subdomain cannot contain its own subdomains.
• Subdomains must be created and managed from a workspace-level Manage Discover page. Account-level subdomain management is not available in this release.

Provide feedback

1. In the Azure Databricks workspace, click your user icon, then click Send feedback.
2. Describe your feedback or issue in detail.
3. Submit your feedback directly to the Azure Databricks product team.

Next steps

After discovering datasets using the Discover page:

• Explore detailed table information, lineage, and relationships in Catalog Explorer.
• Learn more about tags and how to use them to organize your data assets.
• Query data using notebooks or the SQL editor.
• Review table insights to understand how data is being used in your workspace.
• Understand Unity Catalog privileges to manage access to datasets.