> For the complete documentation index, see [llms.txt](https://foxecom.gitbook.io/zest-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://foxecom.gitbook.io/zest-theme/theme-sections/image-with-text-overlay.md).

# Image with text overlay

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

The **Image with text overlay** section lets you combine strong visual imagery with impactful text, making it ideal for storytelling banners, promotional hero blocks, or intros. This section supports separate desktop and mobile images, adjustable text position, and custom opacity settings to ensure readability.

## How to add an Image with text overlay section to your Shopify store

{% hint style="success" %}
Steps

1. In the theme editor (**Customize**), click **Add section.**
2. Select **Image with text overlay.**
3. Make necessary changes.
4. **Save.**
   {% endhint %}

## How to edit an Image with text overlay section

### **Section settings**

<table><thead><tr><th width="285">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Container</strong></td><td>Choose <strong>Full width, Stretched width</strong> or <strong>Fixed width</strong> layout.</td></tr><tr><td><strong>Desktop image</strong></td><td>Upload an image for desktop view. </td></tr><tr><td><strong>Mobile image</strong></td><td>Upload a mobile-optimized version for better responsiveness.</td></tr><tr><td><strong>Image overlay opacity</strong></td><td>Add a dark layer over the image to improve text contrast.</td></tr><tr><td><strong>Banner height</strong></td><td>Choose from: <code>Adapt to image</code>, <code>Small</code>, <code>Medium</code>, <code>Large</code>.</td></tr><tr><td><strong>Desktop content position</strong></td><td>Controls the placement of the content.</td></tr><tr><td><strong>Desktop content alignment</strong></td><td>Aligns text: <code>Left</code>, <code>Center</code>, <code>Right</code>.</td></tr><tr><td><strong>Enable content container</strong></td><td>Keeps the text content within the page width instead of full-width.</td></tr><tr><td><strong>Mobile - Banner height</strong></td><td>Control the image height on mobile</td></tr><tr><td><strong>Show content below images on mobile</strong></td><td><p>Enable showing content below the image for mobile view.</p><p><img src="/files/1W8XOYttHLsYeKGn7ouc" alt=""></p></td></tr></tbody></table>

### Block settings

You can add up to four types of blocks:

<table><thead><tr><th width="285">Block type</th><th>Purpose</th></tr></thead><tbody><tr><td><strong>Subheading</strong></td><td>A short label aside from your headline. </td></tr><tr><td><strong>Heading</strong></td><td>Main headline. Keep it clear, engaging, and meaningful.</td></tr><tr><td><strong>Text</strong></td><td>Add supporting details or a short paragraph.</td></tr><tr><td><strong>Button</strong></td><td>Link to your desired page.</td></tr></tbody></table>

You can re-order blocks by dragging them up or down.

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