Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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
- Your workspaces must not use Private Link Inbound (front-end). URLs for inbound Private Link-protected workspaces fall back to legacy per-workspace URLs.
- Inbound Private Link for account-level resources (such as the account console and account-level Genie One) is supported in Beta.
The following partner connectors do not currently support custom URLs. Configure these connections using your account's legacy URL. All other connectors are supported.
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.
- In the account console, go to Settings > Account settings.
- Click the Claim your URL button to enable the custom URL.
- 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 |
What changes when you use a custom URL
Most Azure Databricks functionality works as-is when you start using a custom URL. The following applications and integrations require additional configuration.
Embedded dashboards for external users
To use your custom URL for dashboards embedded for external users, update your embedding application:
- Replace the workspace-specific instance URL with your custom URL.
- Add the target workspace ID to the
/oidc/v1/tokenand/api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninforequests using theo=<workspace-id>query parameter. Use?o=<workspace-id>when it is the first query parameter, or&o=<workspace-id>when the URL already has query parameters.
See Use the example app to authenticate and generate tokens for complete Python and JavaScript examples.