# Sharing Overview

<figure><img src="https://1875572357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzP7hFWzU2Jj7xMbv2nyp%2Fuploads%2Fgit-blob-c1819599608a67eeefaaeec848409f5df56a6799%2Fshare.png?alt=media" alt=""><figcaption></figcaption></figure>

Notebook contents can be shared with other users and externally in the following ways:

1. Granting notebook permissions
   * Change the base permissions of the notebook
     * Base permissions for notebooks are determined by the (root) folder where the notebook is stored:
       * `Workspace`: All members in the workspace can access
       * [`Teamspace`](https://docs.codatum.com/sharing/teamspace): Members belonging to the teamspace can access
       * `Private`: Only the notebook owner can access
     * Base permissions can be changed by moving the notebook to a different folder
   * Set the additional permissions of the notebook
     * By setting additional permissions, you can [share notebooks](https://docs.codatum.com/sharing/shared-notebook) with specific members or groups within the workspace
     * Notebooks in `Workspace` folders are already shared with the entire workspace, so additional permissions cannot be set
   * [Share notebooks](https://docs.codatum.com/sharing/shared-notebook) with specific users or groups within the workspace
2. Creating and sharing snapshots from notebooks
   * [Report](https://docs.codatum.com/sharing/report): Convert notebooks to reports and share with users in the workspace, including workspace guests
     * When inviting external users as guests, the invited users must have a Codatum account
   * [Public Link](https://docs.codatum.com/sharing/public-link-and-embed): Make it publicly accessible on the internet to anyone who knows the URL
   * [Signed Embed](https://docs.codatum.com/sharing/signed-embed): Integrate into external applications and share with users of those applications

## Summary of Differences in Each Sharing Methods

<table data-header-hidden data-full-width="true"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td>Method</td><td>Editable</td><td>Query execution</td><td>Parameter</td><td>Explorer</td><td>Embeddable</td><td>Guest<br>access</td><td>Login required</td><td>Connection required</td><td>API auth required</td></tr><tr><td>Permission Granting</td><td>true</td><td>Yes</td><td>Yes (values shared)</td><td>Yes</td><td>true</td><td>false</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Report</td><td>false</td><td>Selectable</td><td>Selectable (values per user)</td><td>Selectable</td><td>true</td><td>true</td><td>true</td><td>false</td><td>false</td></tr><tr><td>Public Link</td><td>false</td><td>No</td><td>No</td><td>No</td><td>true</td><td>true</td><td>false</td><td>false</td><td>false</td></tr><tr><td>Signed Embed</td><td>false</td><td>Selectable</td><td>Selectable (values per user)</td><td>Selectable</td><td>true</td><td>false</td><td>false</td><td>false</td><td>true</td></tr></tbody></table>

* Editable: Indicates if users can edit the notebook.
* Query Execution: Shows whether query execution is possible.
* [Parameter](https://docs.codatum.com/data-exploration/parameter-overview): Indicates whether parameters are enabled and specifies if parameters are shared or user-specific.
* Embeddable: Determines if content can be embedded in other platforms using HTML iframes.
* Guest access: Indicates if Workspace Guests can access the shared content.
* Login required: Shows if login to Codatum is required to access the content.
* Connection required: Indicates if connection permissions are required to execute queries and view results.
* API auth required: Indicates if API authentication is required to access the content.

## Guidelines for Choosing a Sharing Method

Choose the appropriate sharing method according to the situation. For example:

### Permission Granting

* For collaborative notebook editing

### Report

* When you don't want to share notebook changes in real-time
  * If you want to make parameter changes separately, consider using the notebook's [version feature](https://docs.codatum.com/data-exploration/notebook/version)
* When sharing with members in the workspace who don't have connection permissions
* When you want to share only specific notebook contents without sharing other workspace data
  * Invite users as Workspace Guests and grant viewing permissions
    * If you have previously logged in with another account, the sign-up screen may not appear when clicking the link in the invitation email. In such cases, please try signing up using incognito mode

### Public Link

* For marketing purposes when you want to share with a large audience
  * Embedding in blogs
  * Sharing on social media like Twitter
* When you want to embed data in internal tools like Notion
  * Consider using Reports if you want to enforce login

### Signed Embed

* When you want to integrate into external applications and share with users of those applications
* When you want to allow access only to users authenticated through your company's authentication system