# Narrative Widget

The Narrative widget allows you to include text or visual data in storied form. Creating Narrative widgets is a great way to display important information or events to your dashboard. You can add a narrative widget to add descriptive explanations to your dashboard about specific data or events. It also comes in handy when creating a report.

**Some Narrative Widget Use Cases Include:**

* Adding non-numerical information to your dashboard.
* Displaying plain text providing information about your data sources or events.
* Explain complex data in a storied form that anyone can understand.

## **How To Add A Narrative Widget To Your Dashboard**

There are several reasons why you need to create a narrative tile. Here are the steps to adding one to your dashboard.

1\. From within your dashboard, click on the **Manage Dashboard** icon at the top-right.

<div align="left"><img src="/files/-MfmdIvbxuaId9-79Y9C" alt=""></div>

2\. Under **Widgets**, click on the Narrative icon (circled red).

<div align="left"><img src="/files/-MfmdIvc8lV9E7xIG_sc" alt=""></div>

The Narrative Tile creation window should pop up. (This is where you set the specifics you want to display on the table). It’s also where you [edit the widget](/features/dashboards/dashboard-tiles/editing-a-tile.md) if you want to change any of its elements.

<div align="left"><img src="/files/-MfmdIvduMtMH057ASia" alt=""></div>

## **General Section**

The narrative widget window is not too different from what we’ve discussed under  [creating tiles](/features/dashboards/dashboard-tiles/creating-a-tile.md).

The first part is the General, where you enter a **title** and **description** for the widget.&#x20;

* For instance, let’s say you want to explain why there’s a sudden increase in traffic. The title can be “Reason for Sudden increase in web traffic.”
* For the description, enter a detailed description that helps you understand what the tile is all about (Sudden increase in traffic in this case).

## **Configuration**

The configuration section is where you enter the text for the narrative. You can input plain text or copy and paste in already typed text.

![](/files/-Mg5sz0mt5DKsTgrzrss)

## **Look and feel**

This section allows you to control the size of the narrative tile. There are several predefined sizes you can choose from including ***unset, small, default, default wide, wide small, wide and full width.***

<div align="left"><img src="/files/-MfmdIven3QlZNoR-ZqB" alt=""></div>

* We will use default wide.

Now we are all done. Just click **Save** to add the Narrative tile to your dashboard.

<div align="left"><img src="/files/-MfmdIvftoUqGT4X_1o0" alt=""></div>

Here’s what our narrative tile looks like based on available data.

![](/files/-MfmdIvghU-Kd_qhOKuz)


---

# 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.foxmetrics.com/features/dashboards/dashboard-widgets/narrative-widget.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.
