# Image with text

{% hint style="danger" %} <mark style="color:red;">Theme retirement</mark> | Context is no longer available on the Shopify theme store. **Theme support and updates for current users will end after May 18, 2024**. [Learn more here](https://help.fluorescent.co/context/readme/theme-retirement).
{% endhint %}

The **Image with text** section combines a feature image with a marketing call to action block. With a flexible layout and optional button, it's a great way to introduce a product collection or something new and exciting.

## Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](https://help.fluorescent.co/context/general/editing-themes/using-templates#create-and-assign-multiple-templates) or [insert dynamic content with metafields](https://help.fluorescent.co/context/general/adapting-your-theme/dynamic-content-with-metafields).d
{% endhint %}

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click **(+) Add block** and select **Button**, then click the new button block.

   ![](https://github.com/fluorescent/kb-context/blob/main/.gitbook/assets/imagewithtext-button.jpeg)
2. Select or paste a URL for the **Link**.
3. Change the **Link text** to display on the button.

   > The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, [read "What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380)
4. Click **Save**.

</details>

## Add feature image

Upload a feature image to display on the left or right of the marketing text block. You can adjust the width and shape of your image.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click the **Image with text** section to open the settings.
2. Click **Select image** to upload and select an image file.

   > There are no required images dimensions. We simply recommend uploaded images have a minimum width of **`2050px`** for optimal quality across all devices.
3. Select the **Image position** to display the image on the **Left** or **Right** side of the section.

   > The text content will display on the opposite side of the image.
4. Choose to set the **Image width** to either **1/2** or **2/3** the width of the section.
5. To change the shape of your original image, select the **Image aspect ratio** to crop your images to **Square**, **Landscape**, or **Portrait**.

   > The default **Natural** setting will display the original orientation of each image.

   ![](https://3096289102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvbp0IBkqpivnJ0UBSwsh%2Fuploads%2Fgit-blob-18e593ad0edf007db92b2db4471c455059562ccf%2Faspect-ratio.jpeg?alt=media)
6. Select the **Image focal point** to choose which section of the image to keep centered within the slide.

   > This setting ensures the key part of your image appears when cropping occurs.
7. Click **Save**.

</details>

## Add section headings

This section has blocks for three text headings. You can customize the alignment, color, and overall look of your text.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Text** blocks to change the **Heading** and **Subheading**.
2. (*Optional*.) Open the section settings to adjust the **Text max width** of your headings using the slider.

   > Experiment with this setting to find a clean visual shape for your text.
3. To change the **Text position**, click on the **Image with text** section and change it to the **Top**, **Center**, or **Bottom** of the image.
4. Click **Save**.

</details>

## Add call-to-action button

You can link to you collections or products or any other page with a custom call-to-action button.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click (**+) Add block** and select **Button**.
2. Click the new **Button** block to open the settings.
3. Select or paste a URL for the **Link**.
4. Change the **Link text** to display on the button.

   > The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, [read "What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380)
5. Select the **Link style** to either show a **Button** or **Link with arrow**.
6. Click **Save**.

</details>

## Settings reference

Click the **Image with text** section to find the following settings.

| Setting            | Description                                                                                                                                                                                                                                                                                                                                                       |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image              | Select or upload one image. There are no required image dimensions but we recommend an image that is square or landscape (wider than it is tall). We recommend uploading an image with a minimum width of 2050px for optimal quality.                                                                                                                             |
| Image position     | Display the image on the Left or Right side of the section.                                                                                                                                                                                                                                                                                                       |
| Image width        | Change the width of image in this section. Either 1/2 (50% of the page width) or 2/3 (66% of the page width).                                                                                                                                                                                                                                                     |
| Image aspect ratio | Choose to crop all images to be a single uniform shape. Select Portrait (2:3), Square (1:1), or Landscape (3:2). Select Natural to display images in their original shape (without cropping).                                                                                                                                                                     |
| Image focal point  | Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes. You can specifya focal point for an image used within a section or for an uploaded image file. Learn more in our [Image settings guide](https://help.fluorescent.co/context/general/image-guide/theme-image-settings).. |
| Heading            | Enter heading text to display as a section title.                                                                                                                                                                                                                                                                                                                 |
| Text               | Enter text to display below the heading.                                                                                                                                                                                                                                                                                                                          |
| Text max width     | Use the slider to adjust the maximum width of the heading and subheading text. Experiment with this setting to find a clean visual shape for your text.                                                                                                                                                                                                           |
| Link               | Select or paste a URL for a button. You can add up to three buttons below the section heading.                                                                                                                                                                                                                                                                    |
| Link style         | Choose to display the link as a Link with arrow or Button.                                                                                                                                                                                                                                                                                                        |
| Link text          | Add text for the label of the link or button.                                                                                                                                                                                                                                                                                                                     |

<br>

***

> **Related links**\
> [Full width image](https://help.fluorescent.co/context/sections/theme-sections/full-width-image)\
> [Slideshow](https://help.fluorescent.co/context/sections/theme-sections/slideshow)\
> [Mosaic grid (2 columns)](https://help.fluorescent.co/context/sections/theme-sections/mosaic-grid-2-columns)
