CRM Integration

Shopify Setup

To enable our Shopify synchronization, go to your funnel's "General" settings and click "Add CRM Sync" and choose "Shopify" as CRM Type.

The Shopify synchronization does not need any additional settings. It will automatically send the analysis results to Shopify when a user has completed the analysis. If the user doesn't exist yet in Shopify (identified by the email address provided in the analysis), a new customer profile will be created. You can see the analysis data in the Shopify admin under "Customers" -> "View customer" and find them in the metadata of the customer profile. The items are the same as the ones in the Klaviyo setup below.

Klaviyo Setup

To enable our Klaviyo synchronization, go to your funnel's "General" settings and click "Add CRM Sync" and choose "Klaviyo" as CRM Type. Afterwards you will need to enter your Klaviyo API key and optionally a list ID if you want to add the customer profile on a dedicated list in addition to the event.

When a user has completed the analysis, we will update the user profile in Klaviyo and send an event message. The payload sent to Klaviyo (same for profile and event)is identical to the webhook payload documented in our webhook documentation.

On Klaviyo profiles (not events), askstella_products_all is always replaced by the most recent analysis across all funnels, while askstella_[funnel_subdomain]_all andaskstella_[funnel_subdomain]_[tab_crm_name] are only replaced when a users completes a new analysis in that same funnel.

If no user (with this email) exists in Klaviyo, we will create a new customer profile and add the event to this new profile. If the user already exists, the event will be added to the user's profile. The same properties of the event will also be set in the user's profile. This way the customer profile will always show the most recent analysis results of the user, while the event history will show all the analysis results the user has received over time.

Klaviyo List

If you provide a list ID in our CRM settings, we will add the user to this list and subscribe them to email marketing in addition to sending the event. The list ID can be found in Klaviyo under "Lists" -> "View list" -> "Settings" -> "List ID". If you want to use a double opt-in list or if you want to subscribe the user directly to the list, you can set this up in Klaviyo.

Klaviyo Examples

The examples below show common ways to use the analysis data we push into Klaviyo in email template. The first example shows a simple product-recommendation email the send the analysis link to the user and highlights one key product from the recommendations before listing all other products. The second example shows how to render the products of a specific result-page tab by loading the product data from our ID arrays using the Klaviyo ↔ Shopify catalog.

Email Setup Example

Video tutorial demonstrating how to set up a Klaviyo flow to send an automated email after a user has completed an analysis. The tutorial covers creating a flow, setting up triggers, and designing the email template with dynamic content (German only):

Used HTML code in this tutorial:

Hallo {{ person.first_name }}! Vielen Dank, dass Du unsere Analyse durchgeführt hast. Hier geht es zu Deinem Analyse
Ergebnis. {{ event.askstella_analysis_url }}

<div style="margin: 9px 18px">
  <strong>Der für Dich passende "Flawless Finish Concealer":</strong>
  {% for product in event.askstella_products_all %} {% if "Flawless Finish Concealer" in product.title %}
  <div style="margin-bottom: 20px">
    <a href="{{ product.link }}">
      {% if product.image %}
      <img src="{{ product.image }}" alt="{{ product.title }}" style="max-width: 100%; height: auto" />
      {% endif %}
      <h3>{{ product.title }}</h3>
    </a>
  </div>
  {% endif %} {% endfor %}
</div>

<div style="margin: 9px 18px">
  <h2>Hier sind Deine weiteren Produktempfehlungen:</h2>
  {% for product in event.askstella_products_all %} {% if "Flawless Finish Concealer" not in product.title %}
  <div style="margin-bottom: 20px">
    <a href="{{ product.link }}">
      {% if product.image %}
      <img src="{{ product.image }}" alt="{{ product.title }}" style="max-width: 100%; height: auto" />
      {% endif %}
      <h3>{{ product.title }}</h3>
    </a>
  </div>
  {% endif %} {% endfor %}
</div>

Tab Product Recommendations Example

This example shows how to render the product recommendations of a specific result-page tab inside a Klaviyo email, pulling live product data (image, title, variant, link) from your connected shop catalog at send time. It uses the askstella_[funnel_subdomain]_[tab_crm_name]event/profile property together with Klaviyo's catalog lookup tag and the variant IDs we provide.

This works with any shop system whose catalog is synced into Klaviyo — Shopify, BigCommerce, WooCommerce, custom catalogs fed through Klaviyo's Catalogs API, etc. The only hard requirement is that the variant IDs we send match the IDs in your Klaviyo catalog so the {% catalog %} lookup can resolve them. The snippet below uses integration='shopify' as a concrete example.

Picking the right array

For a funnel with the subdomain my-funnel and a tab whose CRM name is bestseller, the array on the event and profile is named:

askstella_my-funnel_bestseller

In our platform, go to the menu item "StellaMatch" to see all your funnels and their subdomains. Make sure that the CRM sync to Klaviyo is enabled for the funnel you want to use. The CRM name of the result page tab can be found in the settings of the result page of the respective funnel. Go to the funnel settings and click on "Result Page", then scroll down to the product tabs and click on the tab you are interested in. Below the tab name you will see the CRM name (and can change it if you want).

Each entry of the array has the shape { VariantId: string }, where VariantId is the variant ID from your shop system as it appears in your Klaviyo catalog. To iterate over the array, use the lookup filter. If your flow is triggered by ourAskStella Analysis Completed event, use the event object:

{% for w in event|lookup:'askstella_my-funnel_bestseller' %}
  {# ... w.VariantId ... #}
{% endfor %}

If your flow is triggered from a profile property (list add, segment, etc.), use person object in the lookup filter:

{% for w in person|lookup:'askstella_my-funnel_bestseller' %}
  {# ... w.VariantId ... #}
{% endfor %}

Available catalog fields

Inside a {% catalog VariantId integration='shopify' %} block the following fields are available on catalog_item when the catalog is synced from Shopify. The variant sub-object reflects the exact variant you looked up (e.g. the color), while the top-level fields describe the parent product. Other integrations expose a similar but not always identical set of fields — when in doubt, render {{ catalog_item }} inside a preview to see what your catalog returns.

For a full, always up-to-date reference check Klaviyo's catalog lookup tag documentation.

Template snippet

The block below loops over the first 8 products of the bestseller tab, resolves each variant through the Shopify-synced catalog, and renders a responsive two-column card grid. Products without a usable image are skipped so the layout stays clean. Drop it into a custom HTML / table block in your Klaviyo email template. Replace the subdomain and tab name inaskstella_my-funnel_bestsellerwith your funnel's subdomain and the CRM name of the tab you want to render.

<table width="100%" cellpadding="0" cellspacing="0" border="0">
  <tr>
    <td align="center" style="font-size:0; line-height:0;">

      {% if event|lookup:'askstella_my-funnel_bestseller' %}
        {% for w in event|lookup:'askstella_my-funnel_bestseller' %}
          {% if forloop.counter <= 8 %}

            {% catalog w.VariantId integration='shopify' %}
              {% if catalog_item.featured_image.full.src != "" %}

                <table cellpadding="10" cellspacing="0" border="0"
                       style="display:inline-block; vertical-align:top; width:50%; max-width:320px;">
                  <tr>
                    <td align="center" style="font-size:14px; line-height:1.4;">
                      <table width="100%" cellpadding="12" cellspacing="0" border="0">
                        <tr>
                          <td align="center">

                            <a href="{{ catalog_item.variant.url }}" target="_blank">
                              <img
                                src="{{ catalog_item.variant.featured_image.full.src|default:catalog_item.featured_image.full.src }}"
                                width="260"
                                style="width:100%;max-width:260px;height:auto;display:block;border:0;border-radius:12px;"
                                alt="{{ catalog_item.title }}">
                            </a>

                            <br><br>

                            <strong style="font-size:16px;">
                              <a href="{{ catalog_item.variant.url }}" target="_blank" style="text-decoration:none;">
                                {{ catalog_item.title }}
                              </a>
                            </strong>

                            <br>

                            {% if catalog_item.variant.title != "Default Title" %}
                              <span style="font-size:13px;">{{ catalog_item.variant.title }}</span>
                            {% endif %}

                          </td>
                        </tr>
                      </table>
                    </td>
                  </tr>
                </table>

              {% endif %}
            {% endcatalog %}

          {% endif %}
        {% endfor %}
      {% endif %}

    </td>
  </tr>
</table>

Adapting the snippet

• Replace my-funnel with your funnel's subdomain and bestseller with the CRM name of the tab you want to render. The CRM name is the one you configured for the tab in the funnel builder — it is case-sensitive and must match exactly.
• Change forloop.counter <= 8 to control how many products are shown. Klaviyo limits practical email size, so keep the number reasonable (typically 4–12).
• The default:filter on the image falls back from the variant image to the parent product image when a variant has no dedicated picture. On integrations that don't expose catalog_item.variant.featured_image, drop the variant part and just use catalog_item.featured_image.full.src.
• To show a price, add {% currency_format catalog_item.variant.price %}— this respects your store's currency settings.
• If you want a single-column layout for mobile, change width:50% on the inner card table to width:100%(or use Klaviyo's responsive table blocks instead of the inline style).
• The special array askstella_[subdomain]_all will list all products from this funnel if you do not want to filter by a specific tab (or have no tabs).

Tip: when previewing the email, choose a recipient profile that has actually received an AskStella Analysis Completed event for the funnel. Otherwise the array will be empty and the whole block renders nothing, which is the expected behavior but can feel like a bug during authoring.