> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/data-science-lab-6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/data-science-lab-6/data-science-notebook/notebook-actions/share.md).

# Share

This page describes the steps involved to share a Notebook script and access it as a shared Notebook.

## Sharing a Notebook

The user can share a DSL Notebook across the teams using this feature. 

{% hint style="success" %}
*Check out the walk-through on sharing a Notebook.* 
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2F06AvOxhOZzEDaABNZGJ4%2FShare%20Notebook%20V2.mp4?alt=media&token=7f65e4f1-3182-4c97-a422-40418ba6b957>" %}
***Sharing a Notebook***
{% endembed %}

* Navigate to the ***Workspace*** tab for a DS Lab project.
* Select a Notebook from the list.
* Click on the ***Ellipsis*** icon.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2F4ae0RQo9flFMKmzQuNF5%2Fimage.png?alt=media&amp;token=dbf6973a-542e-4247-8934-56f5f30cbddf" alt=""><figcaption><p><em><strong>Accessing a Notebook from a DSL Project</strong></em></p></figcaption></figure>
* A context menu opens for the selected Notebook, click the ***Share*** option from the Context menu.&#x20;

  <figure><img src="https://content.gitbook.com/content/28ipFzCz8EMtVtHrBFLx/blobs/tZzdBIZTQUBjiGdooYJm/image.png" alt=""><figcaption><p><em><strong>Share option for a DSL Notebook</strong></em></p></figcaption></figure>
* The ***Manage Access** window opens for the selected Notebook.*
* &#x20;Select the permissions to be granted to users/ groups using the checkboxes.
* The Users, User Groups, and Exclude Users tabs appear. Select a tab from the ***Users*** and ***User Groups*** tabs.
* Search for a specific user or user group to share the Notebook.
* Select a User or user group from the respective tabs (as displayed in the image for the Users tab).
* Click the ***Save*** option.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2F1WUow9KC5UFmPSIYnbZA%2Fimage.png?alt=media&amp;token=76a90dc3-0a86-44c1-945b-aed8cf846304" alt=""><figcaption><p>Sha</p></figcaption></figure>
* A notification message appears to ensure about the share action.
* The selected user gets added to the ***Granted Permissions*** section. &#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2Fu4NZN3VMbB95rbMHxRoX%2Fimage.png?alt=media&amp;token=34e6073f-fb77-46a1-9852-51fbdc1dd44e" alt=""><figcaption><p>The Notebook gets shared with the selected user</p></figcaption></figure>

## Accessing a Shared Notebook

{% hint style="success" %}
*Check out the illustration to access a shared Notebook.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FW4n8dgFBrvjvA8h85vnz%2FAccessing%20the%20shared%20NotebookV2.mp4?alt=media&token=c2c2de30-846b-4a13-a200-e7bd8d221cd8>" %}
***Accessing a shared Notebook***
{% endembed %}

* Login to the Platform using the user's credentials to whom the Notebook is shared and navigate to the ***Projects*** page for the ***DS Lab*** module.
* The ***Shared Project*** gets indicated as shared on the ***Projects*** page.
* Click the ***View*** icon to open the project.&#x20;

  <figure><img src="https://content.gitbook.com/content/28ipFzCz8EMtVtHrBFLx/blobs/YVozu8fQ5bXLuzbqXC6r/image.png" alt=""><figcaption></figcaption></figure>
* The ***Workspace*** tab opens by default for the shared Project.
* The shared Notebook would be listed under the Repo folder.
* Open the Notebook Actions menu. The ***Share*** and ***Delete*** options will be disabled for a shared Notebook.

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FrYahDrmTxVq8lVIG4qFC%2Fimage.png?alt=media&amp;token=6f48ee5a-5b5b-42a4-b48c-49a3d1eb25ff" alt=""><figcaption><p><em><strong>Accessing a Shared Notebook</strong></em></p></figcaption></figure>

<details>

<summary>Shared DSL Notebook with View Permission</summary>

When a **Notebook** is shared from User A to User B with **View** Permission, User B will have the following privileges:

* View Notebook Contents.

</details>

<details>

<summary>Shared DSL Notebook with Edit Permission</summary>

When a **Notebook** is shared from User A to User B with **Edit** Permission, User B will have the following privileges:

* View the Notebook contents & edit.
* Edit the Notebook contents and save.

</details>

<details>

<summary>Shared DSL Notebook with Execute Permission</summary>

When a **Notebook** is shared from User A to User B with **Execute** Permission, the User B will have the following privileges:

* View the Notebook contents and Start the Kernel.
* View the Notebook contents and shut down the kernel.
* View the Notebook contents and Execute code and markdown cells.
* View the Notebook contents and interrupt the kernel.
* View the Notebook contents and Execute git commands in the console.
* View the Notebook contents and restart the kernel.

</details>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark>  A targeted share user <mark style="color:red;">cannot</mark>* ***re-share** or **delete** a shared DSL Notebook regardless of the permission level (View/ Edit/Execute).*
{% endhint %}

## Revoking the Granted Permissions

You can revoke the permissions shared with a user or user group by using the ***Revoke Permissions*** icon.

{% hint style="success" %}
*Check out the illustration on revoking the granted permissions.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FzI3gSQjPs91TSoTDrIUl%2FRevoking%20the%20Privileges%20for%20a%20shared%20notebook%20V2.mp4?alt=media&token=b961dcb1-2e12-432f-81a2-5387ca44afe1>" %}
***Revoking the Privileges for a Shared Notebook***
{% endembed %}

* Navigate to the ***Manage Permissions*** window for a shared Notebook.
* The ***Granted Permissions*** section lists all the users or user groups to whom the Notebook has been shared.&#x20;
* Select a user or user group from the list.
* Click the ***Revoke Privileges*** icon.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FopiebtpFowLPci3TSM6E%2Fimage.png?alt=media&amp;token=a53236d6-2167-4356-ad9d-8f00a9a6e980" alt=""><figcaption></figcaption></figure>
* A con
* A notification appears, and the shared privileges will be revoked for the selected user/ user group. The user/ user group gets removed from the ***Granted Permissions*** list.

<figure><img src="https://content.gitbook.com/content/28ipFzCz8EMtVtHrBFLx/blobs/AtRu1yfxUUtpSMQqyleP/image.png" alt=""><figcaption></figcaption></figure>

## Excluding User(s)&#x20;

The user can exclude some users from the privileges to access a shared Notebook while allowing permissions for the other users of the same group.

{% hint style="success" %}
*Check out the illustration on excluding a user/ user group from the shared privileges of a Notebook.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FlcuiTCDuZLyQPINucXKp%2FExcluding%20the%20user%20and%20adding%20the%20user%20for%20Share%20Notebook%20V2.mp4?alt=media&token=3dc63fab-1c8c-48e2-9910-baad064ba3e5>" %}
***Excluding a User from the Shared Privileges for a Notebook***
{% endembed %}

* Navigate to the ***Manage Access*** window for a shared Notebook.
* Grant Permissions to the user(s)/ user group(s) using the checkboxes.
* Open the ***User Groups*** tab.
* Select a User Group from the displayed list.
* Use the checkbox to select it for sharing the Notebook.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FBa0BYXESnvOgTgNcDuTd%2Fimage.png?alt=media&amp;token=ffcaec87-ee00-4247-acf1-34e009bd659d" alt=""><figcaption></figcaption></figure>
* Navigate to the ***Exclude Users*** tab.
* Select a user from the displayed list and use the checkbox to exclude that user from the shared permissions.
* Click the ***Save*** option.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2F24rSQCcEriDfKto9HeBZ%2Fimage.png?alt=media&amp;token=fbbabb7f-ddfe-4024-a185-2ae78db956ba" alt=""><figcaption></figcaption></figure>
* A notification appears to ensure the shared action.
* The selected user gets excluded from the shared Notebook permissions.&#x20;
* The Notebook gets shared with the rest of the users in that group.&#x20;

<figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FB4qi9jxoVVL4xofJvIfE%2Fimage.png?alt=media&amp;token=b768f4ab-adff-4f89-9c84-21443bbe0b59" alt=""><figcaption></figcaption></figure>

### Including an Excluded User

{% hint style="success" %}
*Check out the illustration on including an Excluded user for accessing a shared Notebook.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2Fe1Kj5zsXNJWRJMYF74Jp%2FIncluding%20a%20User%20for%20Share%20Notebook%20V2mp4.mp4?alt=media&token=cd5d5214-a275-479d-a49b-db724c6d4240>" %}
***Including an Excluded User to share Notebook Privileges***&#x20;
{% endembed %}

* Navigate to the ***Excluded Users*** section.
* Select a user from the displayed list.
* Click the ***Include User*** icon.&#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FsYxAJt95rSthPc8h5XXp%2Fimage.png?alt=media&amp;token=16abf97a-7921-484f-a44a-940535c46600" alt=""><figcaption></figcaption></figure>
* The ***Include User*** confirmation dialog box appears.
* Click the ***Yes*** option.

&#x20;       ![](https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FTFTn7nsiW0AF3Wm2KWrH%2Fimage.png?alt=media\&token=6faa86f2-aaf4-45ef-bd1a-fce826be2078)

* A notification appears to ensure the success of the action.
* The selected user gets included in the group with the shared permissions for the Notebook. The user will get removed from the ***Excluded Users*** list. &#x20;

  <figure><img src="https://1760649651-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F28ipFzCz8EMtVtHrBFLx%2Fuploads%2FCaZEGFhN7HvCDjGTa6di%2Fimage.png?alt=media&amp;token=7d27dfff-ea5e-4297-b2da-e8befaa0bd52" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark>*

* *If the project is shared with a user group, then all the users under that group appear under the **Exclude User** tab.*
* *The **Project** gets shared by default with the concerned **Notebook** while using the **Share** function for a Notebook.*
* *A **Shared Project** even if it is shared by default with a Notebook **remains*** ***Active for the user to access the Notebook and open it.***
  {% endhint %}