> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopify.lightsout.agency/llms.txt
> Use this file to discover all available pages before exploring further.

# Tell your story with Facet's rich text section

> Add Facet's rich text section from its two presets, stack headings, text, images and buttons, and turn on text that reveals word by word on scroll.

The Facet rich text section holds headings, text, pictures and buttons in a single column. Use it for a brand statement, an introduction or a short story between other sections. This page covers its two presets, its settings and the blocks it accepts.

![The Rich text section as it appears on the Facet demo storefront.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/rich-text/rich-text-overview.jpg?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=8fb91f5893d8c7cfce70d936d48846ee)

## What this section controls

* The blocks in the column and their order.
* A reveal effect that colors the words in as shoppers scroll.
* The column width, colors and spacing.

## Getting started

**1. Open the Theme Customizer**

In your Shopify admin, open **Online Store**, then **Themes**, and click **Customize** next to Facet.

**2. Add the section**

In the **Sections** panel, click **Add section** and choose **Rich text** or **Rich text with image**. It can't be added to the header or footer.

**3. Write your content**

Click each block to change its wording. Click **Add block** to add a heading, text, image or button.

![The theme editor with the Rich text section selected in the sidebar, its settings panel open on the left and the section highlighted in the preview.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/rich-text/rich-text-location.jpg?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=8d6a1124e35d8be6ff9b2adf77a36865)

### Presets

The section comes in two versions in the **Add section** menu. Both are the same section with different starting blocks, so you can turn one into the other by adding or removing blocks.

* **Rich text**: a large centered heading ("Thoughtful materials") over a centered paragraph in a larger text size.
* **Rich text with image**: a left-aligned heading ("Made to last"), then a full-width 16:9 image, then a left-aligned paragraph.

## Section settings

![Theme editor sidebar showing the Rich text section settings: Reveal text on scroll, Common settings, Color scheme, Top padding, Bottom padding, Page width, and more.](https://mintcdn.com/lightsout/Svjpo54WQSiE2VRv/images/themes/facet/sections/rich-text/rich-text-settings-1.png?fit=max\&auto=format\&n=Svjpo54WQSiE2VRv\&q=85\&s=2e3f9c7c47ce826b3d6bbdf7fd0373f2)

> [accordion] Reveal text on scroll
>
> Off by default. When on, the section fills the screen and centers its content. Every word starts faded and takes its full color as the text scrolls into place, a few words at a time.
>
> Buttons and images are not affected. Shoppers who ask their device to reduce motion see the text as it is, without the effect.

### Common settings

* **Color scheme**: the colors of the section.
* **Top padding**: None, Small, Medium (default), Large or Extra large.
* **Bottom padding**: None, Small, Medium, Large (default) or Extra large.
* **Page width**: Narrow (default), Narrower, Regular, Fluid or Full. This section also offers **Regular**, between Narrower and Fluid.

See [Common settings](https://docs.shopify.lightsout.agency/themes/facet/common-settings.md) for details.

## Blocks

Rich text accepts **Heading**, **Text**, **Image** and **Button** blocks. Add as many as you need and drag them to change their order. See [Theme blocks](https://docs.shopify.lightsout.agency/themes/facet/theme-blocks.md) for their settings.

## Best practices

* **Keep the reveal for short text.** The effect works best on one or two sentences in a large size. Long paragraphs take a lot of scrolling to finish.
* **Use one reveal section per page.** Each one fills the screen, so several in a row slow shoppers down.
* **Keep the narrow width for reading.** Lines of text are easier to read in the **Narrow** or **Narrower** width. Use wider widths when the section holds an image.

## Related guides

> [card] [Theme blocks](https://docs.shopify.lightsout.agency/themes/facet/theme-blocks.md)
>
> Settings for the heading, text, image and button blocks.

> [card] [Statement](https://docs.shopify.lightsout.agency/themes/facet/sections/statement.md)
>
> Mix large words and small pictures in one line.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.