> ## Documentation Index
> Fetch the complete documentation index at: https://docs.expectedparrot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing a Colab notebook

> Save a Colab notebook as supporting material for a study.

First use [Colab setup](https://docs.expectedparrot.com/en/latest/colab_setup.md) to install EDSL and configure any required credentials. Sharing a notebook is separate from saving the survey, job, and completed results; preserve those objects with [Saving objects](https://docs.expectedparrot.com/en/latest/guides/saving_objects.md).

## Download and inspect the notebook

In Colab, download the notebook as an `.ipynb` file. Review its code, cell outputs, and embedded data before sharing. Remove credentials and any private data that should not be included.

From an environment with EDSL and that file available:

```python theme={null}
from edsl import Notebook

notebook = Notebook(path="study.ipynb")
```

Replace `study.ipynb` with the downloaded file's path. This reads the notebook locally; it does not execute its cells.

## Upload supporting material

With Expected Parrot authentication configured:

```python theme={null}
info = notebook.push(
    description="Notebook accompanying the study",
    visibility="private",
)
```

This uploads the notebook. Retain the returned identifier and configure sharing deliberately. See [Notebooks and scripts](https://docs.expectedparrot.com/en/latest/notebooks.md) for updating, downloading, and sharing notebook objects.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.