> For the complete documentation index, see [llms.txt](https://docs.myjuicebox.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myjuicebox.io/building-reports/story-designer/slices/charts/data-card.md).

# Chooser

Summarize measures, and allow user selections to configure other charts dynamically.

A chooser chart can be used to:

* Show a summary of measures
* Let a user choose which measure to use in downstream charts
* Let a user choose which column to use in downstream charts

Choices made in a chooser chart can drive the narrative of the story that follows [using dynamic columns or measures](#using-dynamic-ingredients). There are two types: measure chooser and dimesnion chooser.

## Measure chooser

A chooser chart with measures (i.e., a measure chooser) will display a high-level summary of measures. The selection made in a measure chooser can be used as a [dynamic measure](#using-dynamic-ingredients) in one or more downstream charts, allowing for user-driven exploration.

#### To add a measure chooser slice:

* select **Chooser** from the chart list

![Select Chooser from the dropdown](https://872636700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmfYn9Ab4YpIl0ZZFm-%2Fuploads%2FBiE1liE8WtmTv5bA9dd9%2Fimage.png?alt=media\&token=acdae844-2956-4e80-99fe-1089f1627b9f)

* select the measures you want to add in the order you want them displayed
* add slice text (optional)

![A measure chooser slice](https://872636700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmfYn9Ab4YpIl0ZZFm-%2Fuploads%2FVYtpzuBruXZdIVqLIhds%2Fimage.png?alt=media\&token=afd316b1-9e5d-4cad-b950-177c7b18c3cb)

{% hint style="info" %}
The type of chooser is determined by whether you add a column or measure first. Once you select the first measure, only measures can be added.
{% endhint %}

## Dimension chooser

A chooser chart with dimensions (i.e., a dimension chooser) lets users select one dimension from a group of dimensions for use as a [dynamic dimension](#using-dynamic-ingredients) in one or more downstream charts, allowing for user-driven exploration.

{% hint style="warning" %}
A dimension chooser slice should always be connected to at least one downstream chart. See the [dynamic dimensions](#using-dynamic-columns-or-measures) section below.
{% endhint %}

#### To add a dimension chooser:

* select **Chooser** from the chart list

![Select Chooser from the dropdown](https://872636700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmfYn9Ab4YpIl0ZZFm-%2Fuploads%2FWvdpcj1cvVYRszH7dVDC%2Fimage.png?alt=media\&token=6d50e7fa-75b7-40c3-880e-2d027ccd367a)

* select the dimensions you want to add in the order you want them displayed

![A column chooser slice](https://872636700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmfYn9Ab4YpIl0ZZFm-%2Fuploads%2FGPu6Y4swWhd06N5mwf5z%2Fimage.png?alt=media\&token=bb375ff2-6984-4500-a50f-d45a3c177bd1)

* add slice text (optional)
* click **Save changes**

{% hint style="info" %}
The type of chooser is determined by whether you add a dimension or measure first. Once you select the first dimension, only dimensions can be added.
{% endhint %}

## Using dynamic dimensions or measures

Chooser slices are particularly powerful when slices further down the report refer to the selections in the chooser.

{% hint style="info" %}
Chooser values will be "display only" (i.e., unselectable) unless a downstream slice includes a dynamic dimensions or measure referring to the chooser.
{% endhint %}

To reference the selection made in a chooser slic&#x65;**:**

* Create a dimension chooser or measure chooser using the instructions in the sections above
* In a downstream slice, select the chooser's slice slug in the column dropdown and/or measure dropdown

![Use dynamic ingredients in your charts to make them interactive](https://872636700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmfYn9Ab4YpIl0ZZFm-%2Fuploads%2Fwkg5z4T5nw0dDScWKgNd%2Fimage.png?alt=media\&token=20f2183c-b346-4492-8410-dcc3d27dc605)

Here's how to make your charts dynamic:

{% embed url="<https://www.loom.com/share/460990e6e0464d369bb0f717ec2bfb3c>" %}

After making your chart dynamic, you may want to make your slice text dynamic as well. To learn how, go [here](/building-reports/story-designer/slices/dynamic-text.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.myjuicebox.io/building-reports/story-designer/slices/charts/data-card.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
