# Highlight text with image ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20-%202025-11-24T144102.712_5yU88vUO.jpg) Put small images right inside a large headline to make a brand message, product, or collection stand out.
## How to customize the Highlight text with image section 1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**. 2. Click **Add section**. 3. Select **Highlight text with image**. 4. Click the **Subheading** block to edit the text above the headline. 5. Click the **Main text** block. 6. Enter your headline in **Heading**, and type `[img1]`, `[img2]`, and so on where you want each image to appear. 7. Click each **Image** block inside **Main text** and click **Select** next to **Image** to add the image. 8. Click **Save**. ## Section settings ### Layout | Setting | Description | Options | | ------------- | --------------------------------------------- | ------------------------------- | | **Alignment** | Sets the horizontal alignment of the content. | **Left, Center,** or **Right**. |
### Appearance | Setting | Description | Options | | ---------------- | ----------------------------------------------------------------------------------------------------------------- | :-------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. |
### Padding Controls the top and bottom spacing separately for desktop and mobile. | Setting | Description | Options | | ----------- | ------------------------------------------------------------- | :------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Top** | Controls the space above the section content. | **0–100px**. | | **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks By default, the section includes a **Subheading** block and a **Main text** block with three **Image** blocks inside it. ### Subheading The [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text) block shows a short line above the headline. [*See the **Text block documentation** for all available settings*](https://docs.foxecom.com/pebble-theme/theme-blocks/text). | Setting | Description | Options | | -------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | **Text** | Sets the subheading text. To add an animated highlight, wrap the text in italics using the **I** button in the editor. | Enter your text. | | **Highlight style** | Applies an animated highlight effect to the italic text. | **None, Standard, Wavy underline,** or **Solid background**. | | **Preset** | Sets the typography style of the subheading. | Choose a preset style | | **Color** | Sets the color of the subheading. | **Text** or **Subtext**. | | **Top** | Controls the space above the subheading. | **0–100px**. | | **Bottom** | Controls the space below the subheading. | **0–100px**. | | **Mobile scale** | Scales the padding on mobile. | **20–100%**. | | **Type** (Animation) | Sets the entrance animation of the subheading. | **None, Fade in, Fade up, Slide in (left),** or **Slide in (right)**. |
### Main text The **Main text** block shows the headline and places the **Image** blocks inside it. #### Use image placeholders Type `[imgX]` in **Heading** where you want an image to appear, where X is the image's position in **Main text**: * `[img1]` shows the first **Image** block. * `[img2]` shows the second **Image** block. * `[img3]` shows the third **Image** block. Placeholders follow the order of the **Image** blocks, so if you reorder the blocks, check that each image still appears in the right place. #### Main text - Content | Setting | Description | Options | | -------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Heading** | Sets the headline, including image placeholders. | Enter your text, such as `Sustainability done right [img1] crafted with care [img2]`. | | **Preset** | Sets the typography style of the headline. | **Heading 1–6** or **Custom**. Learn more in [Typography](https://docs.foxecom.com/pebble-theme/theme-settings/typography#text-presets). | | **Font** | Sets the font family of the headline. | **Body** or **Heading**.

*Available when **Preset** is set to **Custom**.* | | **Font weight** | Sets how thick the headline text is. | **Inherit, Light, Regular, Medium, Semi bold, Bold, Extra bold,** or **Black**.

*Available when **Preset** is set to **Custom**.* | | **Font size** | Sets the headline size on desktop. | **12–100px**.

*Available when **Preset** is set to **Custom**.* | | **Font size mobile** | Sets the headline size on mobile. | **12–60px**.

*Available when **Preset** is set to **Custom**.* | | **Line height** | Sets the space between lines of the headline. | **Tight, Normal,** or **Loose**.

*Available when **Preset** is set to **Custom**.* |
#### Main text - Size | Setting | Description | Options | | ----------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Width** | Sets how wide the headline is on desktop. | **Fit:** Fits the width of the text.

**Fill:** Uses the full available width.

**Custom:** Uses the width you set in **Custom width**. | | **Custom width** | Sets the headline width on desktop. | **0–100%**.

*Available when **Width** is set to **Custom**.* | | **Width mobile** | Sets how wide the headline is on mobile. | **Fit, Fill,** or **Custom**. | | **Custom width mobile** | Sets the headline width on mobile. | **0–100%**.

*Available when **Width mobile** is set to **Custom**.* |
Use **Custom** width to control where the headline wraps onto a new line. ### Image Each [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image) block adds one image to the headline at its placeholder. To add an image, click **Add block** inside **Main text** and select **Image**. #### Image - Content | Setting | Description | Options | | --------- | -------------------------------------------------- | ------------------------------------------------------------ | | **Image** | Sets the image shown in the headline. | Select or upload an image, or click **Explore free images**. | | **Link** | Sets where customers go when they click the image. | Paste a link or search. |
#### Image - Size | Setting | Description | Options | | ----------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | **Aspect ratio** | Controls the image proportions on desktop. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)**. | | **Aspect ratio mobile** | Controls the image proportions on mobile. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9), Landscape (4/3),** or **Landscape (21/9)**. | | **Desktop image width** | Sets the image width on desktop. | **50–200px**. | | **Mobile image width** | Sets the image width on mobile. | **40–100px**. |
#### Image - Borders | Setting | Description | Options | | ------------------ | ---------------------------------------------- | ----------------------------------------------------------------------- | | **Border** | Controls whether the image has an outline. | **None** or **Solid**. | | **Border width** | Controls the thickness of the image border. | **0–10px**.

*Available when **Border** is set to **Solid**.* | | **Border opacity** | Controls the opacity of the image border. | **0–100%**.

*Available when **Border** is set to **Solid**.* | | **Corner radius** | Controls how rounded the image corners appear. | **0–32px**. |
## Tips and best practices * Use images with similar proportions in the same headline so the line stays even. * Check the headline on mobile, and lower **Font size mobile**, **Width mobile**, or **Mobile image width** if the images cause awkward line breaks. ## FAQs **Why isn't my image appearing inside the heading?** Check that the heading contains the right placeholder, such as `[img1]`, and that the matching **Image** block has an image selected. The placeholder number must match the image's position in **Main text**. **Can I show different images on desktop and mobile?** No. Each **Image** block uses the same image on both devices, but you can set its aspect ratio and width separately for desktop and mobile.