Sharing notebooks

How to make sure the right people are able to appreciate your work.

Introduction

Note: Only published notebooks can be shared. Draft notebooks can only be seen by their creator.

The notebook sharing menu provides lots of flexibility for how a notebook can be shared.

Depending on what workspace and project settings are active, there are three ways a notebook can be shared.

The notebook sharing menu

Sharing within the project

A notebook is automatically visible to every member of its parent project. Users can share notebooks with other members in the project by just sharing the notebook URL with them.

The notebook share menu shows you the number of users who can view the notebook based on their project permissions. If you are permitted to do so, you can invite other users to the project by clicking "Add people".

Sharing via email/username

Any users with access to a notebook can share it with others using their email address or name. If the invited users aren't members of the workspace they will become a workspace guest.

The invited users will receive a notification email linking them to the notebook directly. If the users are not members of the project they will find the notebook in the "Shared" menu in the workspace.

This option is only available to Viewers or Editors if the "Allow sharing" option is enabled in the Project settings, otherwise it is only available to Project Admins.

Sharing with the whole workspace

This option works the same as sharing via email above but allows users to share with every current and future member of the workspace using one permission. This setting does not include workspace guests.

This option is only available to project viewers or editors if the "Allow sharing" option is enabled in the project settings, otherwise it is only available to project admins.

Sharing on the web

Users can optionally enable the notebook to be shared with anyone who has the link without needing authentication.

This option is only available if the "Allow public links" setting is enabled in the workspace settings.

This option is only available to project viewers or editors if the "Allow sharing" option is enabled in the project settings, otherwise it is only available to project admins.

Embedding notebooks

Published notebooks and cells can be embedded in other web pages. To access the Embed preview pane, click the 'Embed' button in the notebook sharing menu:

Check the appearance of embedded content from the Embed preview pane

To embed a notebook or cell, you can:

  • Use the iframe HTML code directly (for example, on your own website)

  • Paste a notebook or cell link into a platform that supports automatic rich unfurling (for example, a Discourse post)

  • Use the embeddable link (containing 'embed') in a platform that supports rich embeds (for example, a Notion embed block)

Embeds are

  • Fully interactive, like a published notebook (e.g., readers can interact with controls inside embeds)

  • Always in-sync with the notebook

  • Shared like a published notebook (e.g., an embed is only visible to everyone if the notebook is too)

  • Compatible with the oEmbed standard

Embeds do not

  • Allow CSV downloads

  • Support draft notebooks

  • Work with any Count URL other than a notebook or cell URL

Embeds can be disabled workspace-wide from the workspace settings. Only workspace owners can change this setting.

Embed links will always work, but the embed preview pane is only available on the Team plan