# Image with text overlay

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FKSydQ32wx0g1iU800iRX%2FFox-BG%20Light%20(41).jpg?alt=media&#x26;token=81d7015a-2945-486b-a9bf-92d1a1a161af" 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="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FbaWaLS4mPqqIntPZThV9%2Fimage.png?alt=media&#x26;token=24092a8a-9a63-4e09-af2d-9b605ef98e21" 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="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FHLj9Hnp9Mu4PiI0Zs4A7%2Fimage.png?alt=media&#x26;token=21deb41b-0a2e-4eaa-9cf3-559c308e5e0b" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.foxecom.com/zest-theme/theme-sections/image-with-text-overlay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.