Skip to main content

Navigate the Analytics and AI workspace UI

The Analytics and AI workspace UI is where you author and access all of your Databricks objects. The homepage, sidebar, + New menu, and search bar get you to notebooks, queries, dashboards, jobs, and tables, and the Settings menu holds your personal preferences, including workspace language and theme.

You can manage the workspace assets and settings using the workspace UI and the Workspace API. Most of the articles in the Databricks documentation focus on performing tasks using the Analytics and AI workspace UI.

Homepage

The following sections of the workspace homepage provide shortcuts to common tasks and workspace objects to help you onboard to and navigate Databricks:

Ask Genie

Ask Genie is the first section on the workspace homepage. It gives you quick access to three modes:

  • Ask: Ask data questions in natural language. Genie routes your question to the most relevant Genie Agent.
  • Search: Search for workspace objects such as dashboards, notebooks, and queries.
  • Genie Code: Start a Genie Code conversation to author dashboards and analyze data using natural language.

Ask Genie on the workspace homepage.

Suggested

This section displays workspace objects recommended based on your activity.

Favorited

This section displays objects you have marked as favorites.

Popular

This section displays objects with the most user interactions in the last 30 days across product areas, including notebooks, queries, dashboards, and alerts.

Mosaic AI

This section provides quick access to AI-related assets and features.

What's new

This section highlights recently released features and updates in Databricks.

The following common categories are visible at the top of the sidebar:

  • Notebook icon. Workspace
  • Clock icon. Recents
  • Data icon. Catalog
  • Workflows icon. Jobs & Pipelines
  • Cloud icon. Compute
  • Compass icon. Discover
  • Storefront icon. Marketplace
note

There is a lock icon next to items that require an entitlement you aren't assigned.

The features in the following sections are also always visible in the sidebar, grouped by product area:

SQL

  • Query editor icon. SQL Editor
  • Query icon. Queries
  • Dashboard icon. Dashboards
  • Sparkle rectangle icon. Genie Agents
  • Notification icon. Alerts
  • History icon. Query History
  • Cloud database icon. SQL Warehouses

Data Engineering

  • Checklist icon. Runs
  • Ingestion icon. Data Ingestion

AI/ML

  • AI Playground icon. Playground
  • Agents icon. Agents
  • Workspaces icon. AI Gateway
  • Beaker icon. Experiments
  • Layer icon. Features
  • Models icon. Models
  • Cloud model icon. Serving

+ New menu

Click + New to complete the following tasks:

  • Create workspace objects such as notebooks, queries, repos, dashboards, alerts, jobs, pipelines, experiments, models, and serving endpoints.
  • Create compute resources such as clusters, SQL warehouses, and ML endpoints.
  • Upload CSV or TSV files to Delta Lake using the Create or modify table from file upload page or load data from various data sources using the add data UI.

Use the top bar to search for workspace objects such as notebooks, queries, dashboards, alerts, files, folders, libraries, tables registered in Unity Catalog, jobs, and repos in a single place. You can also access recently viewed objects in the search bar. For more information about search features, see Search for workspace objects.

Workspace admin and user settings

Workspace admin and workspace user settings are unified across product areas. SQL settings are combined with general settings to create a unified experience for admin and non-admin users.

All workspace admin settings are now accessed from Settings.

All workspace user settings are now accessed from Settings.

  • The Password setting is on the Profile tab.
  • SQL query snippets (Settings > Developer) is visible to users with the Databricks SQL access entitlement.

Switch to a different workspace

If you have access to more than one workspace in the same account, you can quickly switch among them.

  1. Click the workspace name in the top bar of the Databricks workspace.
  2. Select a workspace from the drop-down to switch to it.

Switch between spaces

The editor uses spaces to organize your tabs, file browser, and search per project. To switch between your spaces, open the spaces list in the editor sidebar. See Organize your work with spaces.

Change the workspace language settings

The workspace is available in multiple languages. To change the workspace language, click your username in the top navigation bar, select Settings and go to the Preferences tab.

Change the workspace theme

The workspace is available in a light and a dark theme. The theme you select applies to the entire workspace UI.

  1. Click your username in the top navigation bar, then select Settings.
  2. On the Preferences tab, under Appearance, select an Interface theme: Prefer light, Prefer dark, or Use system default settings.

You can also set the theme from a notebook by selecting View > Workspace theme. See View notebooks in dark mode.

Get help

This section describes the in-product help experience.

Click Sparkle genie code icon. in the top bar of the workspace to open Genie Code. Enter any question for Genie Code in the text box.

Genie Code is intended to quickly answer questions by referencing Databricks documentation and knowledge base articles. Results include links to any documentation used to answer the question. If Genie Code cannot find documentation related to the user question, it declines to answer. Genie Code is new, so mistakes are possible. Review the linked documentation to verify answers.

In the top bar of Genie Code, click Kebab menu icon. to view the following resources:

  • Settings: View and manage your Genie Code settings.
  • Help: Visit the Help Center to search across Databricks documentation, Databricks Knowledge Base articles, Apache Spark documentation, training courses, and Databricks forums.
  • Send feedback to Databricks: Use the feedback form to submit product feedback from your workspace. See Submit product feedback.

If your organization has a Databricks Support contract, you can also contact Databricks Support directly for additional help in either of the following ways:

  • In the Genie Code pane, click Contact support in the Need additional help? banner above the chat box.
  • Click your user icon in the top bar of the workspace, then click Contact Support.

Managing files and folders

For detailed information about managing files and folders in the workspace browser, see Workspace browser and file management.