> 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/multi-content/theme-block-text.md).

# Group block - Text

**Text** is the wording column of a [Multi-content](/velare/customize-your-pages/storytelling/multi-content.md) row. It holds the part of the story a picture cannot tell: the headline, the paragraph under it, a button to act on, and optional extras such as a small grid of facts, an icon, and social links. Use it beside an image or video block when a shopper needs the reason behind what they are looking at, or on its own when a row is meant to be read rather than looked at.

<figure><img src="/files/8pzFuvMZLSjquyqFx7or" alt=""><figcaption></figcaption></figure>

### 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. In the left sidebar, click the **Multi-content** section.
3. Click **Add block** and choose **Text**.
4. Write the heading and description, then add a button if the wording should lead somewhere.
   {% endhint %}

*Result:* the wording takes its place as one column of the row, at the width and alignment you set below.

### Settings <a href="#settings" id="settings"></a>

#### General <a href="#general" id="general"></a>

<figure><img src="/files/ofFBqvZdHNi1i9dpkU8m" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Color scheme</strong></td><td>The background and text colors behind this column. Schemes are defined in <strong>Theme settings > Colors.</strong> Give it a different scheme from its neighbours when the wording should read as a panel of its own.</td></tr><tr><td><strong>Vertical alignment</strong></td><td><p>Where the wording sits against the taller blocks beside it.</p><ul><li><strong>Top</strong>: lines the first line of text up with the top of the image next to it.</li><li><strong>Middle</strong>: centres the wording against the image, the most balanced option.</li><li><strong>Bottom</strong>: drops the wording so it ends level with the image.</li></ul></td></tr><tr><td><strong>Width</strong></td><td>How much of the row this column claims. Wording usually needs less room than a picture, so it can carry the smaller share.</td></tr></tbody></table>

#### Content settings <a href="#content-settings" id="content-settings"></a>

<figure><img src="/files/LJOhVU1saRG6UOde1lxC" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Content alignment</strong></td><td><p>Which edge the wording lines up with.</p><ul><li><strong>Left</strong>: easiest to read for a full paragraph.</li><li><strong>Center</strong>: suits a short headline with a single button.</li><li><strong>Right</strong>: use it when the picture sits on the right, so the text faces it.</li></ul></td></tr><tr><td><strong>Padding inline</strong></td><td>Breathing room on the left and right of the wording, so the text does not run into the block beside it.<br><em>* Note: Padding inline is automatically optimized for mobile</em>.</td></tr><tr><td><strong>Padding block</strong></td><td>Breathing room above and below the wording, useful when this column has a color scheme of its own and needs to read as a panel.<br><em>* Note: Padding block is automatically optimized for mobile</em>.</td></tr></tbody></table>

### Block settings <a href="#block-settings" id="block-settings"></a>

#### Heading, Subheading, Description <a href="#heading-subheading-description" id="heading-subheading-description"></a>

<figure><img src="/files/6QKlfMLlgOjWZOFMlsqU" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Heading, Subheading, Description</strong></td><td>The three lines of wording in this column: the big line shoppers read first, a short label above it for context, and the paragraph below carrying the detail.</td></tr><tr><td><strong>Width</strong></td><td><p>How much horizontal room the wording is allowed inside the column.</p><ul><li><strong>Fit</strong>: the text stays only as wide as the words themselves.</li><li><strong>Fill</strong>: the text spans the full width of the column.</li></ul></td></tr><tr><td><strong>Typography - Preset</strong></td><td>The font, size, and weight of the wording, taken from the presets in <strong>Theme settings > Typography</strong>. Choose a smaller preset when the paragraph runs long.</td></tr><tr><td><strong>Background</strong></td><td>Puts a solid panel behind the wording, which separates it from a colored or patterned section background.</td></tr><tr><td><strong>Background color</strong></td><td>The color of that panel. Pick one with enough contrast against the wording, or the text becomes harder to read than it was without it.<br><em>* Note: Only appears when <strong>Background</strong> is enabled</em></td></tr><tr><td><strong>Corner radius</strong></td><td>How rounded the corners of that panel look. Higher values give a softer shape, 0 leaves the corners square.<br><em>* Note: Only appears when <strong>Background</strong> is enabled</em></td></tr><tr><td><strong>Padding top/bottom</strong></td><td>Breathing room above and below the wording. Increase it when the text presses against the edge of the column.</td></tr></tbody></table>

#### Button <a href="#button" id="button"></a>

<figure><img src="/files/jM3bn6OHXm0jh3V006zY" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Button label</strong></td><td>The words shoppers click. Leave it empty and no button is shown at all, which leaves the wording with nothing to act on.</td></tr><tr><td><strong>Button link</strong></td><td>Where that click takes shoppers, usually the collection or page the wording is about.</td></tr><tr><td><strong>Type</strong></td><td><p>How much the button stands out from the wording around it.</p><ul><li><strong>Primary</strong>: a solid block of color, for the action you most want taken.</li><li><strong>Outline</strong>: a bordered style, for a secondary action.</li><li><strong>Link</strong>: plain underlined text, the quietest option.</li></ul></td></tr><tr><td><strong>Open link in new tab</strong></td><td>Loads the destination in a second browser tab, so the store stays open behind it. Useful when the link points outside your store.</td></tr><tr><td><strong>Spacing bottom</strong></td><td>Space left under the button. Increase it when the button sits too close to whatever follows it in the column.</td></tr></tbody></table>

#### Grid info <a href="#grid-info" id="grid-info"></a>

**Grid info** displays up to four heading-and-description items in a fixed two-column layout. Removing an item hides only that position without changing the rest of the grid.

<figure><img src="/files/uHyCdechMRnMzjjOSpDx" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Heading</strong></td><td>The bold line of this grid entry. Keep it short, since several entries share the width of the column.</td></tr><tr><td><strong>Description</strong></td><td>The supporting line under it, carrying the detail the heading has no room for.</td></tr></tbody></table>

#### Icon <a href="#icon" id="icon"></a>

<figure><img src="/files/nhcfGW64y9eGi5G8aTOL" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Link</strong></td><td>Where a click on the icon takes shoppers. Leave it blank when the icon is decoration rather than a shortcut.</td></tr><tr><td><strong>Open link in new tab</strong></td><td>Loads that destination in a second browser tab, so the store stays open behind it.</td></tr><tr><td><strong>Image</strong></td><td>Your own artwork in place of a built in symbol, for example a certification mark or a partner logo.</td></tr><tr><td><strong>Svg icon</strong></td><td>One of the symbols that ship with the theme, the quickest route to something that matches the rest of the store.</td></tr><tr><td><strong>Width</strong></td><td>Controls the icon width on desktop. Adjust it to make the icon more or less prominent without changing the surrounding content.</td></tr><tr><td><strong>Mobile settings - Width</strong></td><td>The same on phones, set separately so a symbol sized for desktop does not crowd a narrow screen.</td></tr></tbody></table>

### Social icons <a href="#social-icons" id="social-icons"></a>

<figure><img src="/files/kovtt2iNLwXmwrx0qTLJ" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Spacing bottom</strong></td><td>Space left under the row of social links, so they do not sit against whatever follows them in the column.</td></tr></tbody></table>

### What changes on the storefront <a href="#what-changes" id="what-changes"></a>

* Every part of this block is optional. Fill in only the heading and description and the column stays a plain paragraph.
* The wording inherits its font from **Theme settings > Typography**, so changing a preset there restyles this block along with everything else using it.
* Padding is adjusted for phones automatically, so values set here mainly affect the desktop layout.

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

* [Multi-content](/velare/customize-your-pages/storytelling/multi-content.md): the section this block belongs to
* [Group block - Image](/velare/customize-your-pages/storytelling/multi-content/theme-block-image.md): the picture usually placed beside this wording
* [Typography](/velare/set-up-your-store/typography.md) and [Colors](/velare/set-up-your-store/colors.md): where the presets and schemes come from
* [Social media](/velare/set-up-your-store/social-media.md): where the accounts behind the social icons are set


---

# 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/multi-content/theme-block-text.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.
