Publishing a project

How to publish a project

To publish a project, open the notebook you would like to publish. In the upper right-hand corner select "Share & publish" and then select "Open publishing editor".

Choosing your layout

The Article layout has a more readable layout and a table of contents. This is a great choice for publishing a research paper blog post. The Dashboard layout is wider and allows you to resize and place blocks wherever you like.

Visibility of a published project

Just like you can set the access rights for your project, you can set the access rights for your publication. For example, it is possible to have a private project which is published publicly. In this case, no one will be able to open and edit your project; however, the published version of the notebook will be visible to anyone. Visibility of the published project can be set through the Visibility dropdown in the Publishing Editor.

The following access levels are available:

• Public. Your notebook is visible in your public profile and can be indexed by search engines. Everyone can access the publication, re-run it, and modify any input cells. This is useful if you would like others to come across your work.
• Anyone with a link. Only people with whom you share the link can access the published project. It is hidden from your public profile and search engines.
• Team & collaborators. The only people who can view the publication are the ones who have access to the original project. This will depend on your project sharing settings.

Duplicating a published project

When you publish a notebook in your project, you can decide whether to allow others to duplicate it. If you allow duplication, then anybody who duplicates your project project will have access to all the notebooks and files (images, CSVs, etc.) that were present in the project at the time of publication.

The following items will NOT be exposed when your project is duplicated:

• Project integrations (e.g. BigQuery) and any integration credentials. This includes Environment Variables.
• Any items that were added to the project after it has been published. These items will not show up unless the project is republished.

Republishing

Your notebook is not automatically republished whenever you make changes to it. In order to republish your notebook with the latest changes, go to the Publishing Editor and click on Publish Changes.

The URL of the published project stays the same after republishing, so you don't have to worry about sharing a new URL with your audience.

Interactivity of published projects

Published projects are fully interactive. This means you can create apps or dashboards that require real-time user input.

How does interactivity work?

• Whenever a user interacts with an Input block (e.g. a dropdown menu, a text input) and then clicks on Apply, the whole notebook is run with the new input values.
• Every run is stateless. This means that one user interacting with a publication does not interfere with the runs of any other user.
• Interactive runs are free. This means you are not charged when users interact with your publication.

Interactivity limitations

Note that interactivity of published projects is still heavily in development. Some features that otherwise work in non-published notebook environment may not be supported yet. If you ever come across such issues, reach out to us at help@deepnote.com.

Public profile

You can showcase all of your published notebooks in your public profile, so others can come across your work, follow you, and give you likes!

All published projects with visibility set to Public will automatically appear in your profile.