# Using Notebooks

SingleStore Helios supports Jupyter Notebooks for development using SQL and Python.

## Import and Run Notebooks

> **💡 Tip**: **Get Started Quickly**: Notebooks in SingleStore Helios are Jupyter notebooks and if you are familiar with how to use them, you can jump right in and get started. You can access a collection of notebooks in the Gallery, where you can find how-to guides, tutorials, and getting-started information.

## Import Notebooks

To access Notebooks on the [Cloud Portal](https://portal.singlestore.com) , select **Editor**. There are multiple ways to get started using notebooks:

* **New Notebook**: Start with a new notebook (select **New > New Notebook**) or use a beginner notebook template such as "SingleStoreDB Notebook Basics" (recommended).
* **Import Notebook**: Select **New > Import From File** to import a notebook from your local machine using the **Import file** dialog. Notebook files must be in Jupyter format (`.ipynb`) and the file must not exceed 5GB in size.
* **Gallery**: Select the **Gallery** tab to find how-to guides, tutorials, and getting-started notebooks. If you are new to notebooks, SingleStore recommends using the `beginner` flag and taking a look at the "SingleStoreDB Notebook Basics" or "Getting Started with Notebooks" notebooks. Use labels to filter the notebooks in Gallery. To use or explore a notebook, select the notebook, and then select **Try It Now**. Once opened, this notebook is saved and accessible from the **Recent** and **Personal** tabs on the **Editor** page.

## Run Notebooks

You can run a notebook on the Cloud Portal using any of the following methods.

## Using the Notebooks UI

To run a notebook using the Notebooks UI,

1. Open the notebook on the Cloud Portal.

2. Select a SingleStore deployment, database, and available runtime to run the notebook.

3. Use the available options in the **Run** menu to run the selected cells or all the cells in the notebook.

## Using Fusion SQL Commands in a Notebook Cell

Use the `RUN JOB USING NOTEBOOK` Fusion SQL command in a notebook cell to run another notebook. For example:

```sql
RUN JOB USING NOTEBOOK 'example_notebook.ipynb'
WITH RUNTIME 'notebooks-cpu-small';
```

Refer to [RUN JOB USING NOTEBOOK](https://docs.singlestore.com/cloud/reference/fusion-sql/run-job-using-notebook.md) for more information on this Fusion SQL command.

Optionally, explore the [Running Notebooks from Another Notebook with Fusion SQL](https://www.singlestore.com/spaces/running-notebooks-from-another-notebook-with-fusion-sql/) notebook for an end-to-end example of running a notebook from a different notebook.

## Manage Notebooks

You can perform the basic, non-development notebook tasks such as find, share, create, open/edit, delete, and rename.

## Shared and Personal Tabs

Notebooks are stored in either the **Shared** or **Personal** tabs in SingleStore Helios. Notebooks stored in the Shared tab are accessible by any member of the organization.

Notebooks stored in the Personal tab are only visible to the notebook creator and cannot be shared.

## Create or Open/Edit a Notebook

To create a notebook:

1. From **New**, select **New Notebook**.

   ![Navigate to Editor and create a new notebook.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt519b2348cc165197/6a2c43aefac3703b11511983/Screenshot_2025-11-18_at_11_51_24_AM-xAEL8c.png)

2. Enter a name for the notebook.

3. Select a location ([Personal or Shared](https://docs.singlestore.com/#section-idm4531404441417633540186021063.md)) for the notebook.

4. Select a template from the template list. To create an empty notebook, select **(Blank Notebook)**.

5. Select **Create**.

![Create a blank notebook.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt62b067b88da6e0a2/6a2c43b22fabfd4eefd78025/Screenshot_2025-11-18_at_12_06_30_PM-Zb8SPF.png)

To open (or edit) an existing notebook, select the notebook in the list of notebooks.

## Save a Notebook

Notebooks are automatically saved (autosave) every 5 seconds.

## Share a Notebook

All users within the same organization have access to the notebooks that are located in the **Shared** tab.

To share a notebook, navigate to the **Shared** tab, select **Copy Link** from the (three-dot) under the **Actions** column for your notebook. Share the link with other users in the same organization.

To share a notebook , navigate to the **Personal** tab, [duplicate](https://docs.singlestore.com/#section-idm4498060002691233569399455212.md) the notebook and change the location to a **Shared** tab.

## Rename a Notebook

To rename a notebook, select **Rename** from the (three-dot) under the **Actions** column for your notebook

## Duplicate a Notebook

To duplicate a notebook, select **Duplicate** from the (three-dot) under the **Actions** column for your notebook.

Enter a name for the notebook and select a location. If you duplicate a notebook from the Personal tab to a Shared tab, the new notebook will not be private.

## Delete a Notebook

To delete a notebook, select **Delete** from the (three-dot) under the **Actions** column for your notebook

***

Modified at: May 25, 2026

Source: [/cloud/container-services/notebooks/using-notebooks/](https://docs.singlestore.com/cloud/container-services/notebooks/using-notebooks/)

(An index of the documentation is available at /llms.txt)