# Data Stories

- URL: https://betteranalyst.com/docs/web-dashboards/data-stories
- Updated: 2026-11-17
- Author: Better Analyst

Build a scrolling story of short chapters beside a pinned chart, edit it in place, and make stories from dashboards or dashboards from stories.

A data story walks a reader through your data in short chapters that scroll past one chart. The chart changes with each chapter. Better Analyst picks the charts, puts them in order, and writes a chapter for each one. Every figure in the text is filled in from the chart's data, not typed by the AI, so the figures change when the data refreshes.

Use a story when people need a result explained, such as a monthly client report or a leadership update. Use a [web dashboard](https://betteranalyst.com/docs/web-dashboards/overview) when people need to explore the numbers on their own.

On a wide screen, the chart sits beside the chapters. On a phone, the chart stays at the top while the text scrolls under it.

![A data story about supermarket product lines, with the first chapter beside a pinned bar chart that highlights the leading and lagging product lines](https://betteranalyst.com/docs/web-dashboards/data-stories/story.png)

A finished story: chapters scroll on the left while the chart stays pinned on the right.

## Create a Data Story

1. On the home page, open the mode menu in the message box and select **Data story**. You can also select **New story** on the **Dashboards & Stories** page.
2. Select **Data** to attach files or connected sources.
3. Say what you want explained and who will read it.
4. Send the message. Better Analyst builds the charts first, then writes the chapters and checks every number in them.
5. When the chat shows **Built your story**, select **Open story**.

For example:

> Tell the story of last quarter for our leadership team: how revenue and margin moved, which regions drove the change, and what to look into next.

The **Stories** chip on the home page offers starter prompts, such as a client report or what drove a result. To turn an existing chat into a story, use [Switch mode](https://betteranalyst.com/docs/ai-chat/switch-mode).

When you attach a workbook with several tabs, the story can use all of them. If a tab is missing, ask the story's chat to add it.

If there are too few charts with data, or too few chapters pass the number check, the result opens as a dashboard instead. You can [make a story from it](#make-a-story-from-a-dashboard) later.

## Find Your Stories

Stories are saved in **Dashboards & Stories** in the sidebar, alongside your dashboards. Each story's row says **Story**. When the list has both kinds, use the **All**, **Dashboards**, and **Stories** filters to narrow it.

A story counts toward your plan's dashboard limit, the same as a dashboard. See [Pricing Plans](https://betteranalyst.com/docs/billing/pricing-plans).

## Edit a Story

Open the story and select **Edit**. The story stays on screen while you edit it, and changes save as you go. **Undo** reverses the last change. Select **Done** when you finish.

### Change the Text

Click any heading or paragraph and type. Figures from the charts are shaded. They follow the data, so they change when the data refreshes.

To add a figure, type **@** where you want it. A list of figures from the charts opens. Keep typing to narrow the list, then press Enter or select a figure. Select a shaded figure to see what it is, choose **Swap for another**, or **Remove** it.

You can type a number yourself, but a typed number doesn't change with the data. The edit bar says so while you type.

### Change a Chapter

Each chapter has tools above its text:

- Pick the chapter's chart from the dropdown.
- Move the chapter up or down with the arrows.
- Select **Delete** to remove the chapter. Its chart goes with it, unless another chapter shows that chart or the text quotes it.
- Under **Highlight**, pick values to stand out on the chart while the chapter is read.

When a chapter's chart changes, the chapter shows a note. Select **Rewrite this chapter** to rewrite it from the chart as it is now, or **Keep my words** to leave it.

A story holds up to 12 chapters.

### Add a Chapter

Stories don't have a chart grid. Every chart comes in with the chapter about it.

Select **+ Add a chapter here** above the first chapter or below any chapter, then choose one:

- Under **Ask a question**, type a question and select **Write this chapter**. Better Analyst makes a chart to answer it and writes the chapter from that chart.
- Select **Describe a custom chart…** for a chart drawn your own way, such as a sunburst or progress rings. The custom chart builder opens, and the chapter is written once you add the chart.
- Under **Or write about a chart you have**, pick one of the story's charts. Charts that no chapter uses yet come first.
- Under **Or one of your saved charts**, pick a saved custom chart. It's fitted to the story's data.
- Select **Or write it myself** for an empty chapter. Select **Write this chapter for me** in it to have it written from its chart.

![The New chapter card open below a chapter in edit mode, with Ask a question, Describe a custom chart, the story's charts, and Or write it myself](https://betteranalyst.com/docs/web-dashboards/data-stories/add-a-chapter.png)

The New chapter card opens where you selected + Add a chapter here.

Some questions need new data worked out first. The card then offers **Build it in chat** when the story is open beside its chat, or **Open the chat** on the story's own page. The chat prepares the data and adds the chart and the chapter to the story.

On Free, you can try the custom chart builder, but adding a custom chart to a story needs a paid plan.

### Charts, Data, and Look

- **Chart settings** on the pinned chart opens the same settings a dashboard chart has.
- **Data** opens the datasets behind the story's charts.
- **Customize** sets the text size, which side the chart sits on, chapter numbers, and whether chapters not being read are dimmed. It also sets the story's colors, fonts, and logo.

### Ask in Chat

You can also ask the story's chat for changes, such as "Make it shorter" or "Lead with the regional breakdown." The chat rewrites the chapters and checks every number against the charts.

When the story is open beside its chat, each suggested action at the end of the story has **Build this into the story**. It asks the chat to add a chart and a chapter for that action.

## Make a Story from a Dashboard

1. Open the dashboard from **Dashboards & Stories**.
2. Select **Make a story** in the dashboard header.
3. Better Analyst writes chapters over the dashboard's charts and opens the new story when it's ready.

![A dashboard header with the Make a story button and its tooltip: A new story from these charts. This dashboard stays as it is.](https://betteranalyst.com/docs/web-dashboards/data-stories/make-a-story-button.png)

Make a story sits in the dashboard header, next to Edit.

The story is a new copy in its own chat, named after the dashboard, for example **Sales – Story**. The original dashboard stays as it is. Ask for changes to the story in its new chat.

After a dashboard is built in chat, you can also select **Make a story** beside **Open dashboard**. When the copy is ready, select **Story ready: open it**.

If the charts don't make a story, Better Analyst says so and doesn't make a copy.

**Make a story** is unavailable, with the reason in its tooltip, for:

- Dashboards built from fetched or connected data, such as a database, Google Analytics, or an ad account. In the dashboard's chat, select **+**, then **Switch mode**, then **Data story**. See [Switch Modes](https://betteranalyst.com/docs/ai-chat/switch-mode).
- Dashboards whose data differs per viewer.

Dashboards built in the older format don't show the button.

## Turn a Story into a Dashboard

1. Open the story from **Dashboards & Stories**.
2. Select **Make a dashboard** in the header.

The new dashboard has the story's charts without the chapters. It's a copy in its own chat, named for example **Sales – Dashboard**, and the story stays as it is. In chat, **Make a dashboard** also appears beside **Open story**.

For a story built from fetched or connected data, use **Switch mode** in the story's chat and pick **Build dashboard** instead.

A copy made either way counts toward your plan's dashboard limit.

## Share a Story

Stories share the same way as dashboards. Select **Share** in the story's header, turn on **Public**, and copy the link. Anyone with the link can read the story. Paid plans can also use private links and Brand Kit branding. See [Sharing Web Dashboards with a Brand Kit](https://betteranalyst.com/docs/web-dashboards/sharing-and-brand-kits).

Stories refresh like dashboards, and the figures in the text update with the charts. See [Refresh Support by Source](https://betteranalyst.com/docs/web-dashboards/overview#refresh-support-by-source).

## In a Team

The list follows the project you pick in the project switcher. Only the person who created a story, or an owner or admin, can change, publish, or delete it. Team viewers can read stories but can't make a story or dashboard from them. See [Roles & Permissions](https://betteranalyst.com/docs/teams/roles-permissions).

## Next Steps

- [Build a web dashboard](https://betteranalyst.com/docs/web-dashboards/overview)
- [Share a story or dashboard with your Brand Kit](https://betteranalyst.com/docs/web-dashboards/sharing-and-brand-kits)
- [Continue a chat in another mode](https://betteranalyst.com/docs/ai-chat/switch-mode)
- [Create and configure a Brand Kit](https://betteranalyst.com/docs/brand-kits/creating-brand-kits)
- [Upload files](https://betteranalyst.com/docs/my-data/uploading-files)
