Working with Workspace Objects

This topic explains how to work with folders and other Workspace objects:


Folders contain all static assets within a Workspace: notebooks, libraries, experiments, and other folders. Icons indicate the type of the object contained in a folder. Click a folder name to open or close the folder and view its contents.


To perform an action on a folder, click the Down Caret at the right side of a folder and select a menu item.


Special folders

A Databricks Workspace has three special folders: Workspace, Shared, and Users. You cannot rename or move a special folder.

Workspace root folder

To navigate to the Workspace root folder:

  1. Click the Workspace Icon or Home Icon icon.
  2. Click the Scroll Left Icon icon.

The Workspace root folder is a container for all of your organization’s Databricks static assets.


Within the Workspace root folder:

  • Documentation, Release Notes, and Training & Tutorials are links to different sections in the documentation.
  • the Shared Icon Shared folder is for sharing objects across your organization. Everyone has full permissions for all objects in Shared.
  • the Users Icon Users folder contains a folder for each registered user.

By default, the Workspace root folder and all of its contained objects are available to all users. You can control who can manage and access objects by enabling workspace access control and setting permissions.

To sort all objects alphabetically or by type (folder, notebook, library, experiment) across all folders click the Down Caret to the right of the Workspace folder and select Sort > [Alphabetical | Type]:


User home folders

Each user has a home folder for their notebooks and libraries:

Workspace > Home Folder

If workspace access control is enabled, by default objects in this folder are private to that user.


When you remove a user, the user’s home folder is retained.

Workspace object operations

The objects stored in the Workspace root folder are folders, notebooks, libraries, and experiments. To perform an action on a Workspace object, right-click the object or click the Menu Dropdown at the right side of an object.


From the drop-down menu you can:

  • If the object is a folder:
  • Clone the object.
  • Rename the object.
  • Move the object to another folder.
  • Move the object to Trash. See Delete an object.
  • Export a folder or notebook as a Databricks archive.
  • If the object is a notebook, copy the notebook’s file path.
  • If you have Workspace access control enabled, set permissions on the object.

Search Workspace for an object

To search the Workspace for an object, click the Search icon Search Icon in the sidebar and type a search string in the Search Workspace field. As you type, objects whose name contains the search string are listed.


Access recently used objects

You can access recently used objects by clicking the Recents icon Recents Icon in the sidebar or the Recents column on the Workspace landing page.


The Recents list is cleared after deleting the browser cache and cookies.

Move an object

To move an object, you can drag-and-drop the object or click the Menu Dropdown or Down Caret at the right side of the object and select Move:

Move Drop Down

To move all the objects inside a folder to another folder, select the Move action on the source folder and select the Move all items in ‘<folder-name>’ rather than the folder itself checkbox.

Move Contents Checkbox

Delete an object

To delete a folder, notebook, library or experiment, click the Menu Dropdown or Down Caret at the right side of the object and select Move to Trash. The Trash folder is automatically emptied (purged) after 30 days.

You can permanently delete an object in the Trash by selecting the Menu Dropdown to the right of the object and selecting Delete Immediately.


You can permanently delete all objects in the Trash by selecting the Menu Dropdown to the right of the Trash folder and selecting Empty Trash.


Restore an object

You restore an object by dragging it from the Trash Trash folder to another folder.