---
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: 2538
product: InfluxDB Cloud (TSM)
version: cloud
---

# Create a notebook

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.