---
title: 'Explorer and Notebooks: investigations your team can rerun'
description: >-
  Explorer is one editor for your Supabase database and your logs. Save an
  investigation as a Notebook and anyone on the project can run it again.
author: 'wenbo, joshenlim, saxon_fletcher, charislam'
date: '2026-10-30'
tags:
  - dashboard
  - logs
  - ai
categories:
  - product
---
Explorer is the new query editor in the Supabase Dashboard, and it reaches your logs as well as your database. It introduces Notebooks: a file in your `supabase` folder that combines saved database or log queries with markdown notes. Run a notebook yourself, or have your agent run it as part of its ongoing observations. Explorer is in feature preview and available to every project today. Turn it on under Feature Previews in the Supabase Dashboard.



## Query your database and your logs from one editor

Diagnosing a production problem means reading logs, usage charts, and database reports separately and correlating them yourself. The logs speak a different query dialect, and the connection between them lives in your head. Explorer puts your database and your logs in one editor. Choose a source, write SQL against it, and every result renders as a table or a chart.

If you'd rather describe what you want in plain language, [Supabase Assistant](https://supabase.com/features/ai-assistant), the chat panel built into the dashboard, writes the query inside the same editor, where you can read it and change it before it runs.

Queries of logs carry their own time range, so the query that found the error and the query that found the slow request sit side by side with nothing exported.

## Save your queries, charts, and notes in one place

![Notebooks in the Supabase Dashboard](/images/blog/2026-10-30-explorer-and-notebooks-investigations-your-team-can-rerun/notebooks.webp)

A Notebook is a document that brings together queries of various types as cells, the logic between them, and markdown that describes the reasoning. Any query cell can render its result as a chart. A notebook saves queries rather than results, so running it later always returns current data.

Notebooks are incredibly useful in multi-step analyses and explorations of data, providing a robust tool for investigations that is a dramatic improvement over the status quo. The usual outcome of an investigation is an answer in Slack and an untitled query snippet nobody can find again. A notebook keeps the work. Someone else on the project can pick it up where you left off, and you can re-run the same check after a deploy to confirm the numbers moved the way you expected.

## Ask in plain language, keep the SQL

The Assistant works inside Explorer, too. Ask it to investigate something and it writes the notebook cells, runs them, and persists the notebook for further use. Every create and every edit waits for your approval before it saves, and what you approve is SQL and markdown you can read line by line. You can also ask the Assistant to change a single cell, and it edits that cell in place.

While the Assistant is a powerful tool, nothing here *requires* the Assistant. Explorer is a full SQL workspace with nothing AI-enabled, and a notebook can be written entirely by hand.

## Keep notebooks in your repo

A notebook lives in your `supabase` folder, so it gets the same treatment as the rest of your project. It's versioned, reviewed in a pull request, and checked out by whoever clones the repo. Create one in the dashboard and pull it down with the CLI, or write one locally, including with your own agent, and push it up so it shows in the dashboard. Results aren't saved to the file, so the same notebook works against any branch.

```bash
supabase notebooks pull
supabase notebooks push
```

## Get started

- Explorer is in feature preview. Turn it on under Feature Previews in the Supabase Dashboard and it replaces the SQL Editor in the sidebar.
- The `notebooks` commands are available in the [beta version of the CLI](https://supabase.com/docs/guides/local-development/cli/getting-started#beta-channel).
