

# Working with data stories in Amazon Quick Sight


With Generative BI with Quick Sight, authors and readers can generate a first draft of their data story quickly. Use prompts and visuals to produce a draft that incorporates the details that you provide. Data story drafts are not meant to replace your own ideas or to perform analysis. Rather, data stories are a starting point to customize and expand on as needed. The contextual recommendations and suggestions combine your prompt with selected visuals to provide relevant details that are tailored to your data story. For more information about this, see [Generative BI with Quick Sight](quicksight-gen-bi.md).

Use the following topics to create, modify, and share a data story.

**Topics**
+ [

# Creating a data story with Generative BI
](working-with-stories-create.md)
+ [

# Personalize data stories in Amazon Quick Sight
](working-with-stories-personalize.md)
+ [

# Viewing a generated data story in Amazon Quick Sight
](working-with-stories-view.md)
+ [

# Editing a generated data story in Amazon Quick Sight
](working-with-stories-edit.md)
+ [

# Adding themes and animations to a data story in Amazon Quick Sight
](working-with-stories-themes.md)
+ [

# Sharing a data story in Amazon Quick Sight
](working-with-stories-share.md)

# Creating a data story with Generative BI
Creating a data story

Use the following procedure to create a data story with Generative BI.

**To create a data story**

1. Open the [Quick console](https://quicksight.aws.amazon.com/).

1. At left, choose **Stories**.

1. On the **Data stories** page, choose **New Data Story**.

1. In the **Story** screen that appears, navigate to the **Build story** modal and input a data story prompt that you would like to generate. For the best results, don't phrase the prompt like a question. Instead, type the data story that you want Quick Sight to build. For example, say you want to create a data story about the most commonly performed medical procedures by region. A good prompt for this use case is "Build a data story about most commonly performed procedures by physicians in various regions. Also, show the specialties where patients are admitted the most. Recommend where we need to staff more physicians by specialty, and include at least four points of supporting data."

   You can optionally skip this step and manually create your data story. If you choose to forego entering a prompt, you still need to add a visual to the data story.

1. Under **Select visuals**, choose **Add**.

1. Choose the dashboard that contains the visuals that you want to use, and then choose the visuals that you want. You can add up to 20 visuals to a data story.

   If you don't see the dashboard that you want to use, use the **Find your dashboards** search bar at the top of the modal.

   You can choose visuals from any number of dashboards that you have sharing permissions to. Visuals that show a **Restricted** badge have permissions that restrict them from being added to a data story. A visual might be restricted for one of the following reasons:
   + The dataset is connected to a data source that uses trusted identity propagation with Amazon Redshift.
   + The dataset is located inside of a restricted folder.

1. (Optional) Use the **Select documents** section to upload up to 5 documents to be used in the data story. Each document can't exceed 10MB. These documents are only used to generate the data story and are not stored in Quick Sight. The following image shows the **Select documents** section of the **Build story** screen.

1. (Optional) If your Quick account is connected to an Amazon Q Business application, check the **Use insights from Amazon Q Business** checkbox to augment your data story with unstructured data sources from Amazon Q Business. For more information about connecting a Quick account to a Amazon Q Business application, see [Augmenting Amazon Quick Sight insights with Amazon Q Business](generative-bi-q-business.md).

1. Choose **Build**.

After the data story generates, review the data story and choose from the following options:
+ **Keep** – Saves the generated content to the canvas. When you choose this option, the **Build story** modal closes and you can start editing your data story.
+ **Try again** – Allows users to edit the prompt and generate a new data story.
+ **Discard** – Deletes the generated data story.

# Personalize data stories in Amazon Quick Sight


User location and job-related information from your IAM Identity Center instance are leveraged to generate personalized data stories that are more relevant to authors and readers. For example, when an author in the US issues the prompt “Write a business strategy focusing on a plan on how to increase the revenue in my location", insights related to the US in the data story's narrative are automatically included. If the author wants the data story to focus on another country such as Canada, they can specify this in the prompt.

For personalization to work, you must add country and job title for users in the IAM Identity Center instance that is connected to your Quick account. For more information, see [Add users to your IAM Identity Center directory](https://docs.aws.amazon.com/singlesignon/latest/userguide/addusers.html) in the IAM Identity Center User Guide.

User data in your IAM Identity Center instance is connected to your application environment by default. This means that all data stories are personalized by default. You can choose to [opt out of personalization](https://docs.aws.amazon.com/quicksuite/latest/userguide/qs-q-manage-personalization) at any time in the Account settings menu in the QuickSight administration console.

**Note**  
Personalization in data stories is currently available in the US East (N. Virginia) and US West (Oregon) AWS Regions.

# Viewing a generated data story in Amazon Quick Sight


After you generate and keep a data story, you can access that data story from the **Data stories** page. To view a data story, choose the data story that you want to view to open the story editor.

As you create and modify a data story, you can preview how the data story looks to readers. To preview a generated data story, choose the **Preview** icon at the top of the page. To exit the preview, choose **BACK TO EDITOR**.

# Editing a generated data story in Amazon Quick Sight


After you create and keep a data story, you can modify its content to better fit your needs. You can format data story text, add images, edit visuals, and add new blocks.

Stories are made up of different *blocks* that act as containers for text, visuals, and images that you want to include in your data story. Each block can be formatted indepenently from other blocks in the data story, similar to the sections of a pixel perfect report.

To format the text of a data story, use the toolbar at the top of the page. The toolbar offers font settings so you can customize the font type, style, color, size, spacing, text highlights, and alignment. You can also use the toolbar to add columns to a data story block.

Use one of the following options to add a visual to a data story.
+ Use the **Visuals** pane to drag and drop a visual into a data story. Only the visuals that you chose when you generated the data story are shown in the **Visuals** pane.

  You can also choose the **Add** (\$1) icon in the **Visuals** pane to add new visuals that can be dragged and dropped into the data story. Each data story can contain up to 20 visuals.
+ Choose the data story block that you want to add an image to. When a cursor appears, enter a forward slash (`"/"`) to insert an image or visual to that data story block.

To edit a visual in a data story, choose the visual that you want to change, and then choose the **Properties** icon. In the properties pane that appears, you can perform the following actions:
+ Change, hide, or show the visual's title. By default, the visual title is displayed.
+ Change, hide, or show the visual's subtitle. By default, the visual subtitle is hidden.
+ Hide or show data labels. By default, data labels are hidden.
+ Hide, show, or change the position of the legend. By default, the legend is hidden.

To add a new block to a data story, choose the plus (\$1) icon at the bottom of any existing block. Then choose the layout option that you want. You can also move, duplicate, or delete a block from the **Block options** (three dots) icon at the top of each block.

To change the layout of items in a block, you can drag and drop the items wherever you want with the six-dot icon next to each item.

# Adding themes and animations to a data story in Amazon Quick Sight
Themes and animations

You can add themes and animations to the stories that you generate. To add a theme or animation to a data story, choose the **Story style** icon.

In the **Story style** pane that appears, you can perform the following actions:
+ For **THEMES**, choose a theme that you think best fits your data story.
+ For **ANIMATIONS**, choose an animation style and speed. For animation types, you can choose **None**, **Fade**, or **Slide**. The default animation is **None**. For **Speed**, choose **Slow**, **Medium**, or **Fast**. The default speed is **Medium**.

# Sharing a data story in Amazon Quick Sight


Use the following procedure to share a data story.

**To share a data story**

1. In the story editor of the data story that you want to share, choose the **Share** icon at the top right.

   Alternatively, you can choose the **Share** icon at the top of a data story preview.

1. In the **Share data story** modal that appears, enter the users or groups that you want to share the data story with.

1. (Optional) To save a link for the published data story to your clipboard, choose **Copy Link**.

1. Choose **Publish & Share**.

If you try to share a story and receive a message that the story cannot be shared, contact the owner of the dashboard ask them to toggle on the **Allow sharing data stories** switch. For more information about this switch, see [Tutorial: Create an Amazon Quick Sight dashboard](example-create-a-dashboard.md).

If you try to share a data story and receive an error message, contact the owner of the dashboard or your Quick account admin for assistance.

After you share a data story, users you shared the story with receive a notification email with a link to the story. You can access the data story from the **Data stories** page of their Quick accounts. You can also share the copied link to the data story with users that can access the data story.

You can't share a data story that contains restricted data. If you try to share a story that contains restricted data, an error message appears that lists all restricted visuals that are a part of the story. If desired, remove the restricted visuals from your data story before sharing it with users.

When you edit a published data story, republish the data story for the changes to propagate to your end users.