Give your Azure Databricks account a custom URL

Important

This feature is in Public Preview.

A custom URL gives your Azure Databricks account a single, branded entry point (for example: acme.databricks.com) that replaces the collection of per-workspace URLs that account users navigate today. After enabling a custom URL, users can log in to their Azure Databricks account and move freely between workspaces and Genie One without reauthenticating.

Eligibility

Eligible account admins can claim and enable a custom URL directly from the account console. The following eligibility requirements apply:

  • Your account must be a paying, verified customer account.
  • The account admin enabling the custom URL must have a non-reserved domain email address.

If you have previously been assigned a custom URL, it will appear automatically in your account settings. To rename your custom URL, contact your Azure Databricks account team.

Note

Azure Databricks reserves the right to change, reclaim, or revoke a custom URL at any time. Where possible, we provide advance notice and help coordinate a replacement.

Requirements

The following PECO connectors do not yet support Custom URLs. All other connectors are supported. The following partner connectors do not currently recognize custom URLs. Configure these connections using your account's legacy URL.

Assign a custom URL

Note

If you have previously been assigned a custom URL, it will appear automatically in your account settings. If you would like to rename your existing custom URL, contact your Azure Databricks account team.

  1. In the account console, go to Settings > Account settings.
  2. Click the Claim your URL button to enable the custom URL.
  3. Optionally, enable the auto-redirect setting to automatically redirect all legacy workspace URLs to your Custom URL.

After you enable the custom URL, navigate to Genie One at acme.azuredatabricks.net/one. Users in your account can now access assets across any workspace they have access to without being prompted to log in again.

Developer tooling support

The following Azure Databricks developer tools support custom URLs. Upgrade to at least the minimum version listed to ensure compatibility.

Tool Minimum version
CLI / DABs 1.0.0
Terraform 1.114.0
Go SDK 0.130.0
Python SDK 0.103.0
Java SDK 0.105.0
VS Code extension 2.11.0