---
title: "How to add a dynamic image to a push notification"
description: "Learn how to add a dynamic image to a push notification."
canonical_url: "https://help.klaviyo.com/hc/en-us/articles/18596283143707"
markdown_url: "https://help.klaviyo.com/hc/en-us/articles/18596283143707.md"
locale: "en-us"
category: "Push Notifications"
section: "Send push notifications"
updated: "2026-11-06"
---

# How to add a dynamic image to a push notification

## You will learn

Learn how to add a dynamic image to a push notification. 

Dynamic images are a great way to personalize your push notifications. For instance, you can show someone the exact product they favorited, started a checkout with, or bought.

## Before you begin

Use a standard push notification and complete the [rich push notification setup](https://help.klaviyo.com/hc/en-us/articles/16917302437275.md) for your app before adding an image.

You can use dynamic images in:

- Metric-triggered flows, using either event data (e.g., items from a checkout or placed order) or catalog tags for an event. 

- Campaigns and list- and segment-triggered flows, using profile data, such as an image URL stored as a custom property on the recipient’s profile.



Also, note the following regarding push dynamic images: 

- Only 1 dynamic image is allowed per push notification.

- Use images 1 MB or smaller to help them load reliably.

- You can use conditional statements with dynamic images.

- If the image property is empty for a recipient, the push notification still sends without an image.



**📝 Note:** Want to request a feature for Klaviyo push notifications? Fill out this [Google form](https://forms.gle/7iPm6JQ4eKB6H2C4A) to tell us about it!

## Add a dynamic image to a push notification

1. Select the push notification you want to edit in your flow or campaign.

2. For a flow, click **Edit** next to **Content**. For a campaign, open the push message’s content editor using **Edit**.

3. Enter the notification’s message text and complete any required message settings before previewing.

4. Click **Preview & test**.



![View Details icon within the push preview window](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/e240b3c9a262c2562d3ae4a63c7b83478e8f8239-1308x596.jpg?auto=format)

5. Choose an event that contains the image URL for a metric-triggered flow, or a profile with the image URL custom property for a campaign or list- or segment-triggered flow. Expand **All properties** and find the image URL under **Event properties** or **Custom properties**.

6. Click the property containing the image URL to copy its full variable. For a list of products or images, `0` identifies the first item and may appear in the middle of the variable, as in `{{ event.extra.line_items.0.product.images.0.src }}`.



![Example of what the data source looks like for an image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/65a679bb726f9a9f66a94e4c26c77f7b68be2da3-434x916.jpg?auto=format)

7. Click **Done** to return to the editor. Turn on **Attachment** and click **Select image** (or **Select media** if shown).



![Add media to push.jpg](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/30a940666a154f51fc12a846401c1378d49bfb2b-409x317.jpg?auto=format)

8. Go to the **Dynamic image** tab.

9. Paste the dynamic variable or dynamic URL for the image.




![Dynamic Image tab after pasting in an example variable](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/665966fba3c8f52c293f52cce876d7dd3a797316-1572x404.png?auto=format)

10. Click **Save**.

11. Click **Preview & test** and check that the expected image appears for the selected event or profile. If it does not, check the image URL and try another event or profile with an image value. Click **Done** when finished.

12. Click **Save & continue** for a flow. For a campaign, click **Next** or **Save and return**, depending on the campaign editor.



**▸ Example of using catalog tags**

You can also use catalog tags to add dynamic images in a rich push notification. To do so: 

1. Go to **Analytics > Metrics**. 

2. Select the metric you want to use (e.g., *Ordered Product*) and open the **Activity feed** tab.

3. Open the menu for a specific event and select **Activity details**.

4. Find the property whose value matches the item ID in your Klaviyo catalog, such as ProductID. Use a SKU only if it is the item’s catalog ID.

5. Copy the label for the tag (except any parentheses or colon) so you have the exact spelling and capitalization.
In the example below, we copy "ProductID".




![image5.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/ef8fe6632fbec36af8c74f37cdde15eac9b68af0-606x420.png?auto=format)

1. Paste this somewhere you won't lose it. 

2. Navigate to a flow triggered by the same metric you just selected. 

3. Select the push notification where you want to include your dynamic image.

4. Click **Edit** next to **Content**. Enter the notification’s message text and complete any required message settings.

5. Turn on **Attachment** and click **Select image** (or **Select media** if shown).



![Add media to push.jpg](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/30a940666a154f51fc12a846401c1378d49bfb2b-409x317.jpg?auto=format)

1. Go to the **Dynamic image** tab.

2. Paste in the following catalog tag:
`{% catalog event.id %} {{catalog_item.featured_image.thumbnail.src}} {% endcatalog %}`

3. Replace id in {% catalog event.id %} with the label you previously copied.
Example: {% catalog event.ProductID %} {{catalog_item.featured_image.thumbnail.src}} {% endcatalog %}

4. Click **Save**. 

5. Click **Preview & test** and check the image using an event that contains a matching catalog item ID. Click **Done**, then **Save & continue**.

**▸ Example of using conditional statements for dynamic images**

Dynamic images can use conditional statements. 

Below is an example of an if/else statement to say that if there's a variant image, show that to recipients; else, use the default image:

`{% if event.extra.line_items.0.product.variant.images.0.src %}{{ event.extra.line_items.0.product.variant.images.0.src }}{% else %}{{ event.extra.line_items.0.product.images.0.src }}{% endif %}`

Note that the exact format for these statements depends on your integration, and you should not copy them from email templates.

## Additional resources

- [Understanding rich push notifications](https://help.klaviyo.com/hc/en-us/articles/16917302437275.md)
  Learn about rich push notifications in Klaviyo. Rich push notifications are available for both campaigns and flows. 
- [How to use event data to personalize email and SMS flows](https://help.klaviyo.com/hc/en-us/articles/115002779071.md)
  Learn what dynamic event data is, when to use it, where to find it, and how to include it in your flow messages. Learn about the different actions your customers take, and how you can use that data for creating personalized messaging flows in Klaviyo. For instance, you could use event data in an abandoned cart flow message to show individuals what product they left behind, an image of the item, and more. This allows for a more personalized experience for the customer, as well as a higher chance of conversion.
