Similar items in Klaviyo emails

The Email (Klaviyo) card in SearchIQ Connections provides a store-level feed on Growth and above. Each set contains one popular product and up to four visually similar, in-stock products from your covered catalog. It uses your shop currency and includes product titles, links, images and prices.

Popularity means products opened from SearchIQ search or recommendations in the previous 30 complete days. SearchIQ chooses up to five products daily, when the feed is next requested. Similar matches are cached for 15 minutes. A store without recorded opens or eligible matches has an empty feed.

What this feed can do

Use these sets as a store-wide discovery section. All recipients receive the same selection. It does not choose alternatives using an individual recipient's browse or back-in-stock event. Klaviyo uses shared cached web-feed content for sends, as explained in its web-feed guide.

Keep your existing Shopify catalog connection for Klaviyo's own product blocks and event-specific flows. This URL is a web feed, not a custom catalog source.

Connect the feed

1. In SearchIQ, open Connections → Email (Klaviyo) and choose Create feed URL.
2. Choose Copy feed URL. Keep this private: anyone with it can read the product feed. It contains no shopper data.
3. In Klaviyo, open Settings → Other → Web feeds → Add web feed.
4. Set the name to SearchIQ_Trending, select GET and JSON, and paste the URL. Validate it.
5. Add an HTML block to your email and use the sample below. Preview before sending.

For the drag-and-drop editor, you can instead repeat a block over feeds.SearchIQ_Trending.sets with the alias set. The seed title is {{ set.product.title }}. Its matches are in set.similar. The Klaviyo guide covers content repeat.

Sample template

Paste this into a Klaviyo HTML block. The first loop visits sets; the second visits their similar items. It renders nothing when the feed has no sets. Customize the heading and design for your email.

{% for set in feeds.SearchIQ_Trending.sets %}
  <h2>More like {{ set.product.title }}</h2>
  {% for item in set.similar %}
    <p>
      <a href="{{ item.url }}">
        <img src="{{ item.image }}" alt="{{ item.title }}" width="160">
        {{ item.title }}
      </a>
      {{ item.price.amount }} {{ item.price.currency }}
    </p>
  {% endfor %}
{% endfor %}

The JSON contains sets, selection_date, refreshed_at and basis. A set has a product card and a similar array. Every card has id, title, url, image and a price object with amount and currency. Prices use your shop currency rather than personalized market pricing.

Refreshes and availability

SearchIQ checks current stock and plan coverage each time Klaviyo fetches the URL. Klaviyo has its own cache, so a send may still show earlier data. Product availability can also change after an email is sent. Refresh and preview the feed before a campaign. Confirm links, currency, images and the empty-feed case.

Requests are limited to 60 per minute per token. A 429 response means to wait for the indicated Retry-After interval. Free and Starter do not have feed access; downgrading makes the URL unavailable.

Replace the token

Choose Regenerate token, then Replace feed URL in the on-page warning. The previous URL stops working on SearchIQ immediately. Copy the replacement into Klaviyo and validate it before sending. Klaviyo may retain an earlier cached response; changing the token cannot remove content already cached or sent. Remove or update affected email blocks while fixing a feed connection.

Back to the SearchIQ guide