Give your Databricks account a custom URL
This feature is in Public Preview.
A custom URL gives your 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 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 Databricks account team.
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 account must be enabled for unified login. Accounts created after June 21, 2023, and those that configured SSO after December 12, 2024, have this enabled automatically.
- If your workspace uses Inbound Private Link, you can configure Inbound Private Link for custom URLs with context-based ingress policies to your workspaces and account-level resources.
Assign a custom URL
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 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.databricks.com/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 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 Databricks functionality works as-is when you start using a custom URL. The following applications and integrations require additional configuration.
Unity Catalog connections with OAuth
For Unity Catalog connections that prompt users to sign in with OAuth through a customer-managed third-party application, add a callback URI that uses the custom URL to the application's allowed redirect URIs. Keep the callback URI that uses the workspace URL if users can still access that URL. The callback path varies by connection type. For example, for an HTTP connection, add https://<custom-url>/login/oauth/http.html to the third-party application's redirect URL allowlist.
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.