# Enriching a story with descriptions

## Overview <a href="#overview" id="overview"></a>

Toucan allows you to enrich stories by adding **descriptions** to contextualize data in a Story and improve end-user understanding.

Descriptions are dynamic: they depend on the selected app filter values.

{% hint style="info" %}
**Note**

Say you have a filter with all your customers and another for date selection. You can add a description for ‘ACME’ during ‘last month’ and a different description for ‘Umbrella Corp’ during the same timeframe.
{% endhint %}

## Configuration <a href="#configuration" id="configuration"></a>

{% hint style="warning" %}
**Prerequisites:**\
To add descriptions to stories:

* Users should have one of those privileges:
  * Business Specialist (Viewers)
  * Owner
  * Contributor
* The story should be linked to at least 1 "app filter."
* The app should be in Production mode
  {% endhint %}

## How to add a description <a href="#how-to-add-a-description" id="how-to-add-a-description"></a>

*Note: In the filter, the value of **date ranges** is interpolated to reflect the actual date range it represents. For example, ‘Current Month’ can be interpolated as ‘01/01/2023 to 31/01/2023’*

### Add a description <a href="#add-a-description" id="add-a-description"></a>

Click on the button on the top right of the Story (“Add a description”).

### Edit a description <a href="#edit-a-description" id="edit-a-description"></a>

To edit an existing description, hover it and click the pen icon.

### Delete a description <a href="#delete-a-comment" id="delete-a-comment"></a>

To edit an existing description, hover it and click the bin icon.

## How descriptions are displayed <a href="#how-descriptions-are-displayed" id="how-descriptions-are-displayed"></a>

Descriptions are displayed at the top of Stories. If the Story already has a narrative, the description will be displayed below the narrative.

You can display different descriptions by selecting different "app filter" values.

## How to display a narrative or description in PDF Reports <a href="#how-to-display-a-narrative-or-description-in-pdf-reports" id="how-to-display-a-narrative-or-description-in-pdf-reports"></a>

When adding/editing a story in a PDF report, you can display narratives and/or descriptions by ticking the right option. The options will be available if the story has at least one narrative or one description.


---

# Agent Instructions: 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:

```
GET https://docs-v3.toucantoco.com/collaboration/enriching-a-story-with-descriptions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.