---
title: Create a notebook
description: Create a notebook to explore, visualize, and process your data.
url: https://docs.influxdata.com/influxdb/cloud/tools/notebooks/create-notebook/
estimated_tokens: 1742
product: InfluxDB Cloud (TSM)
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/cloud/tools/notebooks/create-notebook/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

Create a notebook to explore, visualize, and process your data.
Learn how to add and configure cells to customize your notebook.
To learn the benefits and concepts of notebooks, see[Overview of Notebooks](/influxdb/cloud/tools/notebooks/overview/).

* [Create a notebook from a preset](#create-a-notebook-from-a-preset)
* [Use data source cells](#use-data-source-cells)
* [Use visualization cells](#use-visualization-cells)
* [Add a data source cell](#add-a-data-source-cell)
* [Add a validation cell](#add-a-validation-cell)
* [Add a visualization cell](#add-a-visualization-cell)

## Create a notebook from a preset

To create a new notebook, do the following:

1. In the navigation menu on the left, click **Notebooks**.

   Notebooks

2. In the **Notebooks** page, select one of the following options under **Create a Notebook**:

   * **New Notebook**: includes a [query builder cell](#add-a-data-source-cell), a [validation cell](#add-a-validation-cell), and a [visualization cell](#add-a-visualization-cell).
   * **Set an Alert**: includes a [query builder cell](#add-a-data-source-cell), a [validation cell](#add-a-validation-cell), a [visualization cell](#add-a-visualization-cell), and an [alert builder cell](#add-an-action-cell).
   * **Schedule a Task**: includes a [Flux Script editor cell](#add-a-data-source-cell), a [validation cell](#add-a-validation-cell), and a [task schedule cell](#add-an-action-cell).
   * **Write a Flux Script**: includes a [Flux script editor cell](#add-a-data-source-cell), and a [validation cell](#add-a-validation-cell).

3. Enter a name for your notebook in the **Untitled Notebook** field.

4. Do the following at the top of the page:

   * Select your local time zone or UTC.
   * Choose a time [range](/flux/v0/stdlib/universe/range/) for your data.

5. Your notebook should have a **Data Source** cell as the first cell. **Data Source** cells provide data to subsequent cells. The presets (listed in step 2) include either a **Query Builder** or a **Flux Script** as the first cell.

6. To define your data source query, do one of the following:

   * If your notebook uses a **Query Builder** cell, select your bucket and any additional filters for your query.
   * If your notebook uses a **Flux Script** cell, enter or paste a [Flux script](/influxdb/cloud/query-data/flux/).

7. (Optional) Change your visualization settings with the drop-down menu and the **Configure** button at the top of the **Visualize the Result** cell.

8. (Optional) Toggle the **Presentation** switch to display visualization cells and hide all other cells.

9. (Optional) Configure notebook actions
   (**Alert** or **Task**)
   .

10. (Optional) To run your notebook actions, select and click **Run** under the notebook title.

11. (Optional) To add a new cell, follow the steps for one of the cell types:

   * [Add a data source cell](#add-a-data-source-cell)
   * [Add a validation cell](#add-a-validation-cell)
   * [Add a visualization cell](#add-a-visualization-cell)
   * [Add an action cell](#add-an-action-cell)

12. (Optional) [Convert a query builder cell into raw Flux script](#convert-a-query-builder-to-flux) to view and edit the code.

## Use Data Source cells

### Convert a Query Builder to Flux

To edit the raw Flux script of a **Query Builder** cell, convert the cell to Flux.

You can’t convert a **Flux Script** editor cell to a **Query Builder** cell.
Once you convert a **Query Builder** cell to a **Flux Script** editor cell, you can’t convert it back.

1. Click the  icon in the **Query Builder** cell you want to edit as Flux, and then select **Convert to |\> Flux**.
   You won’t be able to undo this step.

   A **Flux Script** editor cell containing the raw Flux script replaces the **Query Builder** cell.

2. View and edit the Flux script as needed.

## Use visualization cells

* To change your [visualization type](/influxdb/cloud/visualize-data/visualization-types/), select a new type from the drop-down list at the top of the cell.
* (For histogram only) To specify values, click **Select**.
* To configure the visualization, click **Configure**.
* To download results as an annotated CSV file, click the **CSV** button.
* To export to the dashboard, click **Export to Dashboard**.

## Add a data source cell

Add a [data source cell](/influxdb/cloud/tools/notebooks/overview/#data-source) to pull information into your notebook.

To add a data source cell, do the following:

1. Click .
2. Select **Flux Script** or **Query Builder** as your input, and then select or enter the bucket to pull data from.
3. Select filters to narrow your data.
4. Select**Run** in the upper left drop-down list.

## Add a validation cell

A validation cell uses the **Table** [visualization type](/influxdb/cloud/visualize-data/visualization-types/) to display query results from a data source cell.

To add a **Table** visualization cell, do the following:

1. Click .
2. Under **Visualization**, click **Table**.

## Add a visualization cell

Add a visualization cell to render query results as a [Visualization type](/influxdb/cloud/visualize-data/visualization-types/).

To add a Table visualization cell, do the following:

1. Click .

2. Under **Visualization**, select one of the following visualization cell-types:

   * **Table**: Display data in tabular format.
   * **Graph**: Visualize data using InfluxDB visualizations.
   * **Note**: Use Markdown to add notes or other information to your notebook.

To modify a visualization cell, see [use visualization cells](#use-visualization-cells).
For detail on available visualization types and how to use them, see [Visualization types](/influxdb/cloud/visualize-data/visualization-types/).

## Add an action cell

Add an [action cell](/influxdb/cloud/tools/notebooks/overview/#action) to create an [alert](/influxdb/cloud/monitor-alert/)or

process data with a [task](/influxdb/cloud/process-data/manage-tasks/)

.

* [Add an Alert cell](#add-an-alert-cell)

*
* [Add a Task cell](#add-a-task-cell)

### Add an Alert cell

To add an [alert](/influxdb/cloud/monitor-alert/) to your notebook, do the following:

1. Enter a time range to automatically check the data and enter your query offset.
2. Customize the conditions to send an alert.
3. Select an endpoint to receive an alert:
   * Slack and a Slack Channel
   * HTTP post
   * PagerDuty

4. (Optional) Personalize your message. By default, the message is:

   ```
   ${strings.title(v: r._type)} for ${r._source_measurement} triggered at ${time(v: r._source_timestamp)}!
   ```

5. Click **Test Alert** to send a test message to your configured **Endpoint**. The test will not schedule the new alert.
6. Click **Export Alert Task** to create your alert.

### Add a Task cell

To add a [task](/influxdb/cloud/process-data/manage-tasks/) to your notebook, do the following:

1. Click .
2. Click **Task**.
3. Enter a time and an offset to schedule the task.
4. Click **Export as Task** to save.