# Sharing Overview

<figure><img src="/files/BIiKneFP9NUA5iUwtvl3" 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`](/sharing/teamspace.md): 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](/sharing/shared-notebook.md) 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](/sharing/shared-notebook.md) with specific users or groups within the workspace
2. Creating and sharing snapshots from notebooks
   * [Report](/sharing/report.md): 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](/sharing/public-link-and-embed.md): Make it publicly accessible on the internet to anyone who knows the URL
   * [Signed Embed](/sharing/signed-embed.md): 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](/data-exploration/parameter-overview.md): 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](/data-exploration/notebook/version.md)
* 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.codatum.com/sharing/sharing-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.