Non-admins see a subset: personal settings, tokens, notifications

The Databricks workspace UI is organised around a left-hand navigation sidebar with sections for data exploration, compute management, notebook development, workflow orchestration, and SQL analytics. Understanding this layout lets you locate any feature in seconds and move efficiently between tasks.

    Who this is for:

    Part of the Getting Started with Databricks section of the Databricks tutorial series.

    Architecture / Concept Overview: Non-admins see a subset: personal settings, tokens, notifications

    The workspace UI is divided into functional sections that map to different user activities. Data engineers spend time in Workflows and Repos, analysts live in the SQL Editor and Dashboards, and data scientists work primarily in Notebooks and Experiments.

    %%{init: {"theme":"base","themeVariables":{"background":"#0B0E14","primaryTextColor":"#E0E6ED","lineColor":"#5D6470","darkMode":true,"primaryColor":"#2E4A4A","secondaryColor":"#374151","secondaryTextColor":"#E0E6ED","tertiaryColor":"#111827","tertiaryTextColor":"#E0E6ED","edgeLabelBackground":"#1f2937"}}}%% graph TD classDef source fill:#3F4B59,stroke:#9CA3AF,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef ingestion fill:#5A4B36,stroke:#C9A86B,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef processing fill:#535072,stroke:#8E82B4,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef storage fill:#2E4A4A,stroke:#5FAFA8,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef serving fill:#3D5550,stroke:#6BB7AA,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef governance fill:#5A3F52,stroke:#C28BB0,stroke-width:2px,rx:8,ry:8,color:#E0E6ED Sidebar[Left Sidebar] Sidebar --> Home[Home] Sidebar --> Workspace[Workspace Browser] Sidebar --> Repos[Repos / Git] Sidebar --> Data[Data Explorer] Sidebar --> Compute[Compute] Sidebar --> Workflows[Workflows] Sidebar --> SQLSection[SQL] SQLSection --> Editor[SQL Editor] SQLSection --> Dashboards[Dashboards] SQLSection --> Alerts[Alerts] class Sidebar processing class Home source class Workspace ingestion class Repos governance class Data storage class Compute serving class Workflows processing class SQLSection serving class Editor serving class Dashboards serving class Alerts governance

    *Figure 1 — Workspace UI structure: sidebar navigation and its child sections.*

    %%{init: {"theme":"base","themeVariables":{"background":"#0B0E14","primaryTextColor":"#E0E6ED","lineColor":"#5D6470","darkMode":true,"primaryColor":"#2E4A4A","secondaryColor":"#374151","secondaryTextColor":"#E0E6ED","tertiaryColor":"#111827","tertiaryTextColor":"#E0E6ED","edgeLabelBackground":"#1f2937"}}}%% flowchart LR classDef source fill:#3F4B59,stroke:#9CA3AF,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef ingestion fill:#5A4B36,stroke:#C9A86B,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef processing fill:#535072,stroke:#8E82B4,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef storage fill:#2E4A4A,stroke:#5FAFA8,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef serving fill:#3D5550,stroke:#6BB7AA,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef governance fill:#5A3F52,stroke:#C28BB0,stroke-width:2px,rx:8,ry:8,color:#E0E6ED Engineer[Data Engineer] --> WF[Workflows] Engineer --> Repos2[Repos] Analyst[Analyst] --> SQLE[SQL Editor] Analyst --> Dash[Dashboards] Scientist[Data Scientist] --> NB[Notebooks] Scientist --> Exp[Experiments] class Engineer source class Analyst ingestion class Scientist processing class WF serving class Repos2 governance class SQLE serving class Dash serving class NB processing class Exp storage

    *Figure 2 — How different personas typically use the workspace UI sections.*

    %%{init: {"theme":"base","themeVariables":{"background":"#0B0E14","primaryTextColor":"#E0E6ED","lineColor":"#5D6470","darkMode":true,"primaryColor":"#2E4A4A","secondaryColor":"#374151","secondaryTextColor":"#E0E6ED","tertiaryColor":"#111827","tertiaryTextColor":"#E0E6ED","edgeLabelBackground":"#1f2937"}}}%% flowchart LR classDef source fill:#3F4B59,stroke:#9CA3AF,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef ingestion fill:#5A4B36,stroke:#C9A86B,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef processing fill:#535072,stroke:#8E82B4,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef storage fill:#2E4A4A,stroke:#5FAFA8,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef serving fill:#3D5550,stroke:#6BB7AA,stroke-width:2px,rx:8,ry:8,color:#E0E6ED classDef governance fill:#5A3F52,stroke:#C28BB0,stroke-width:2px,rx:8,ry:8,color:#E0E6ED Search[Global Search] --> Notebooks2[Find Notebooks] Search --> Tables[Find Tables] Search --> Jobs[Find Jobs] Search --> Users2[Find Users] class Search processing class Notebooks2 serving class Tables storage class Jobs ingestion class Users2 source

    *Figure 3 — Global search provides quick access to any workspace asset.*

    Key Terms

    Prerequisites and Setup

    • An active Databricks workspace with login credentials
    • At least viewer-level permissions in the workspace
    • A modern web browser (Chrome, Firefox, or Edge recommended)
    • Familiarity with your role (engineer, analyst, or scientist) to focus on relevant sections

    Step-by-Step Implementation

      Configuration Reference

      Non-admins see a subset: personal settings, tokens, notifications configuration options
      FeatureKeyboard ShortcutDescription
      Global SearchCtrl/Cmd + PFind any workspace asset
      New NotebookN/A (use + button)Create notebook from sidebar
      Run CellShift + EnterExecute current notebook cell
      Command PaletteCtrl/Cmd + Shift + PAccess all editor commands
      Toggle SidebarCtrl/Cmd + BShow/hide left navigation
      Switch Language%python, %sql, %mdChange cell language in notebooks

      Monitoring, Cost, and Security Considerations

      Monitoring

      Use the Compute page to monitor running clusters and their resource utilisation. The SQL Warehouse monitoring tab shows query queue depth and execution times. Job run history in Workflows provides pipeline health at a glance.

      Cost Optimisation

      Terminate idle clusters from the Compute page. Monitor warehouse auto-stop behaviour. Use the Admin Console billing section to identify which resources consume the most DBUs.

      Security and Governance

      Review active personal access tokens in your user settings periodically. Check workspace access lists if enabled. Use the Admin Console to audit user permissions and group memberships.

      Common Pitfalls and Recommended Patterns

      • Not using Global Search — it is the fastest way to find anything; learn the keyboard shortcut
      • Ignoring the Data Explorer — browsing tables visually is faster than writing discovery queries
      • Navigating only by clicking — keyboard shortcuts significantly accelerate the workflow
      • Not favouriting frequently used items — the Home page becomes more useful with curated favourites
      • Overlooking the SQL Editor for quick exploration — it starts faster than spinning up a notebook cluster
      • Not customising notification preferences — default settings may be too noisy or too quiet

      Frequently Asked Questions

      Can I customise the sidebar?

      The sidebar structure is fixed by Databricks, but you can collapse/expand sections and use favourites on the Home page for quick access to your most-used items.

      Where do I find my query history?

      In the SQL Editor, click the "Query History" tab in the left panel. For notebook commands, check the cluster's "Spark UI" or the notebook revision history.

      How do I share a notebook with a colleague?

      Right-click the notebook in the Workspace Browser and select "Share". Set permissions (view, edit, manage) per user or group.

      Is there a dark mode?

      Yes. Access appearance settings through your user profile menu. Dark mode applies to the entire workspace UI.

      Can I access the workspace from mobile?

      The workspace UI is responsive but optimised for desktop browsers. Read-only access to dashboards works on mobile devices, but notebook editing requires a desktop browser.