> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/media-with-text.md).

# Media with text

The Media with text section combines images or videos with text content, ideal for storytelling, highlighting features, or emphasizing brand values.

Pair an image or video with text, buttons and other content blocks. It's ideal for storytelling, product features or brand values.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FjIxnmDlnt9qlAZdVEPR6%2Fscreencapture-poetic-theme-jewelry-myshopify-2025-12-05-13_58_36.png?alt=media&amp;token=a95744df-386a-4ff0-aa3d-7763626d801e" alt=""><figcaption></figcaption></figure>

### 1. How to add the section

{% stepper %}
{% step %}
In the theme editor, click **Add section**.
{% endstep %}

{% step %}
Choose **Media with text** (in the **Storytelling** category). It's added with a heading, text and a button.
{% endstep %}
{% endstepper %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FUfrUWRsWTnrnkgW1Xiac%2FScreenshot%202025-10-01%20at%203.13.49%E2%80%AFPM.png?alt=media&amp;token=cb9b66a4-6202-4cbb-a71d-8c8fe160cfc5" alt=""><figcaption></figcaption></figure>

### 2. Section settings

**General**

* **First image:** the main image.
* **Second image:** an optional second image, shown as a decorative image on top of the first one.
* **Video:** a video uploaded to Shopify. When you add a video, it's shown instead of the images.
* **Media height:**
  * **Adapt to first media size:** keeps the image or video's own proportions.
  * **Small**, **Medium** or **Large:** fixed heights, set in [Appearance](https://help.byinspiredlabs.com/theme-settings/appearance.md).
  * **Custom:** set an exact **Custom height** from 200 to 1000px.
  * **Adapt to content height:** the media matches the height of the text area.
* **Desktop media width:** Small, Medium or Large. On mobile, the width is adjusted automatically.
* **Desktop media placement:** **Media first** (media on the left) or **Media second** (media on the right). On mobile, the media always shows first.
* **Desktop content position:** Top, Middle or Bottom.
* **Desktop content alignment:** Left, Center or Right.
* **Add space between media and text:** adds a gap between the media and the text box.

**Colors**

* **Color scheme** for the section and **Container color scheme** for the text box.

**Mobile layout**

* **Mobile content alignment:** Left, Center or Right.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}

### 3. Block settings

Click **Add block** to add content to the text area.

* **Heading:** your title, with **Heading size** from Small to Extra extra large.
  * **Enable key words highlight:** select words in the heading and press the italic button, then turn this on. Choose a **Highlight style** (Color or Underline) and a **Highlight color**.
* **Text:** a description to support the heading.
* **Caption:** a short tagline. **Text style:** Subtitle or Uppercase.
* **Collapsible content:** a **Question** that opens to show its **Answer**. You can add an **Icon** next to the question. Turn on **Use custom colors** to set the **Background**, **Text** and **Icon** colors.
* **Image:** an extra small image, with an **Image width** of 30 to 200px.
* **Countdown timer:** set the **End date** and **End time**, the **Number font** (Body or Heading), **Hide when countdown reaches zero** and the **Style** (With border or No border).
* **Button** (one per section): **Button label**, **Button link** and **Button style** (Solid, Outline or Text). Turn on **Use custom color** to choose a button color.
* **Icon:** an icon with a short text next to it.
  * **Text style:** Body, Subtitle or Uppercase.
  * **Icon:** choose from the icon list.
  * **Use custom colors:** set the **Text** and **Icon** colors.
* **Feature columns:** two features shown side by side (stacked on mobile). For **Feature 1** and **Feature 2** you can set:
  * **Icon:** choose an icon, or **None** to show no icon.
  * **Icon size:** 20 to 80px.
  * **Alternative icon/image:** upload your own icon or image to use instead.
  * **Icon alignment:** Left, Center or Right.
  * **Heading**, **Heading size** (Small, Medium or Large) and **Description**.
  * **Use custom colors:** set the **Text** and **Icon** colors. The icon color applies to the built-in icons only.
* **Divider:** a line to separate content. Set the **Line opacity** (0–100%), **Width** (0–100%) and **Alignment** (Left, Center or Right).
