# Highlight text with image

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.