> For the complete documentation index, see [llms.txt](https://uxsmart.gitbook.io/velare/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uxsmart.gitbook.io/velare/customize-your-pages/storytelling.md).

# Storytelling

Storytelling includes flexible sections for presenting products, brand stories, reviews, FAQs, editorial content, galleries, banners, and other supporting information. Use them to highlight products, explain benefits, build trust, answer questions, and create a more engaging flow between sales-focused sections.

Most stores only need a few of these sections. Choose the ones that best support your products, content, and customer journey.

### Where to find it <a href="#where-to-find-it" id="where-to-find-it"></a>

{% hint style="success" %}
**Steps:**

1. Go to **Online Store > Themes > Customize**.
2. Open the template you want to edit, for example the home page.
3. Click **Add section**.
4. Open the **Storytelling** group and choose a section.
5. Drag the section to the position you want on the page.
   {% endhint %}

*Result:* the section is added with placeholder content, and its settings open on the right so you can start filling it in.

### Sections in this group <a href="#sections-in-this-group" id="sections-in-this-group"></a>

| Section                                                                                       | What it does                                                                                          | Reach for it when                                            |
| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [Faqs](/velare/customize-your-pages/storytelling/faqs.md)                                     | Questions and answers in an accordion, with an optional image and call to action                      | Support keeps answering the same few questions               |
| [Featured review slider](/velare/customize-your-pages/storytelling/featured-review-slider.md) | A slider of full width testimonials built from media and content blocks, with star ratings            | One or two reviews deserve more room than a grid gives them  |
| [Flexible section](/velare/customize-your-pages/storytelling/flexible-section.md)             | An empty canvas you fill with theme blocks, with control over direction, height, and background media | No ready made section matches the layout you have in mind    |
| [Gallery image](/velare/customize-your-pages/storytelling/gallery-image.md)                   | A row of images as a carousel or a marquee, each one linkable                                         | You want to show social or lifestyle photography             |
| [Icon box](/velare/customize-your-pages/storytelling/icon-box.md)                             | Icons with a heading and description, side by side                                                    | You need to state shipping, returns, or guarantees quickly   |
| [Multi-content](/velare/customize-your-pages/storytelling/multi-content.md)                   | A mixed row of image, text, video, and media with text blocks                                         | One row has to carry several different kinds of content      |
| [Reading text](/velare/customize-your-pages/storytelling/reading-text.md)                     | Editorial text that reveals itself as the shopper scrolls, over a fixed background                    | You are telling a brand or campaign story                    |
| [Rich text](/velare/customize-your-pages/storytelling/rich-text.md)                           | A simple block of heading, text, and button                                                           | You just need words in the middle of a page                  |
| [Scrolling banners](/velare/customize-your-pages/storytelling/scrolling-banners.md)           | Stacked banner cards with image and wording that scroll horizontally                                  | Several promotions have to share one slot                    |
| [Scrolling text](/velare/customize-your-pages/storytelling/scrolling-text.md)                 | A marquee of text and icons that runs across the page                                                 | A short message should be visible without taking much height |
| [Testimonials](/velare/customize-your-pages/storytelling/testimonials.md)                     | A review carousel with thumbnails of the reviewers                                                    | You have a set of shorter reviews to rotate through          |

### Suggested reading order <a href="#suggested-reading-order" id="suggested-reading-order"></a>

1. Start with [Faqs](/velare/customize-your-pages/storytelling/faqs.md) and [Icon box](/velare/customize-your-pages/storytelling/icon-box.md). They answer practical doubts, and they earn their place on almost every store.
2. Then choose one review format: [Testimonials](/velare/customize-your-pages/storytelling/testimonials.md) for a rotating set of short quotes, or [Featured review slider](/velare/customize-your-pages/storytelling/featured-review-slider.md) when a single review should fill the screen. Using both on one page dilutes each of them.
3. Read [Rich text](/velare/customize-your-pages/storytelling/rich-text.md), [Reading text](/velare/customize-your-pages/storytelling/reading-text.md), and [Gallery image](/velare/customize-your-pages/storytelling/gallery-image.md) when you get to brand storytelling.
4. Leave [Flexible section](/velare/customize-your-pages/storytelling/flexible-section.md) and [Multi-content](/velare/customize-your-pages/storytelling/multi-content.md) for last. They are the most open ended, so they are easier once you know how the ready made sections behave.

### Related pages <a href="#related-pages" id="related-pages"></a>

* [Banners](/velare/customize-your-pages/banners.md): the sections for large promotional imagery, often placed just above a storytelling section
* [Blog](/velare/customize-your-pages/blog.md): another way to publish longer form content
* [Basic blocks](/velare/customize-your-pages/basic.md): the blocks you drop into [Flexible section](/velare/customize-your-pages/storytelling/flexible-section.md)
* [Colors](/velare/set-up-your-store/colors.md), [Typography](/velare/set-up-your-store/typography.md), [Layout](/velare/set-up-your-store/layout.md): the theme settings every section in this group inherits from


---

# 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://uxsmart.gitbook.io/velare/customize-your-pages/storytelling.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.