Share files

This page describes how to share workspace files with users, groups, and service principals in your workspace.

Note

Access control is available only in the Premium plan.

File permissions

You can assign five permission levels to files: NO PERMISSIONS, CAN READ, CAN RUN, CAN EDIT, and CAN MANAGE. The table lists the abilities for each permission.

Ability

NO PERMISSIONS

CAN READ

CAN RUN

CAN EDIT

CAN MANAGE

Read file

x

x

x

x

Comment

x

x

x

x

Attach and detach file

x

x

x

Run file interactively

x

x

x

Edit file

x

x

Modify permissions

x

Workspace admins have the CAN MANAGE permission on all files in their workspace. Users automatically have the CAN MANAGE permission for files they create.

Configure file permissions

This section describes how to manage permissions using the Databricks workspace UI. You can also manage permissions using the Permissions API or the Databricks Terraform provide.

You must have the CAN MANAGE permission on the file in order to manage permissions on it.

  1. Click the file in the workspace browser.

  2. Click Share. The Sharing dialog appears.

    Share a file
  3. Search for and select the groups, users, and service principals, and assign the permission level.

  4. Click Add.

You can also copy the link to the file in the Sharing dialog.

Manage file permission with folders

You can manage file permissions by adding file to folders. Files in a folder inherit all permissions settings of that folder. For example, a user that has CAN RUN permission on a folder has CAN RUN permission on the files in that folder. To learn about configuring permissions on folders, see Folder permissions.

To learn more about organizing files into folders, see Workspace browser.