Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.privy.com/llms.txt

Use this file to discover all available pages before exploring further.

The Product block allows you to quickly access and incorporate products from your Shopify catalog into your emails and displays. Simply add the block into your content, select the product, and customize the block’s title, image, and layout.
Note: This functionality is only available for accounts integrated with Shopify at this time.

Product Blocks in Email

Add a new product block

  • Navigate to your Campaigns or Flows to either select an existing email you’d like to edit, or create a new email.
  • Once you’re in the email editor, drag and drop the Product block from your Content menu on the right.
From here, you can choose to include Static products, or a Dynamic product block.

Static Products

A static product block displays fixed products that you manually select. These same products will appear for all recipients, and will stay the same until you manually change them. To add a static product block to your email:
  • Drag a new product block into your content.
  • Select the new product block inside your email to expand its settings on the right.
  • Click Select Products to choose the specific product(s) you want to include in your email.
  • Customize your block’s settings as needed.
You can filter your products by status (In Stock, Out of Stock, All Products).Items with a Not Tracked status indicate Shopify products without inventory tracking. Learn more about Shopify inventory tracking here.

Dynamic Products

A dynamic product block will automatically populate products based on the criteria you choose. These products may vary among recipients and/or change over time. Choose from:
  • Recently Viewed — products the recipient has recently browsed.
  • Most Viewed — your store’s most-viewed products, ranked by page views over the chosen time period. Requires the Privy Web Pixel.
  • Best Selling — your top-selling products, ranked by units sold over the chosen time period.
  • Back in Stock — products that have returned to stock.
  • Recently Added — products most recently created in your Shopify catalog.
To add a dynamic product block to your email:
  • Drag a new product block into your content.
  • Select the new product block inside your email to expand its settings on the right.
  • Select Dynamic under your Product Settings.
  • Customize your criteria using the dropdown menu under Products to recommend.
  • For Most Viewed, Best Selling, and Recently Added, set a Time Period to control the ranking window.
  • Customize the rest of your block’s settings as needed.
Note: Dynamic Product Blocks are currently only available in Privy Flows.
Most Viewed needs the Privy Web Pixel installed with the read_customer_events scope. If scopes are missing, the Flow email editor shows an error badge with a link to fix permissions in Shopify.

Fallback Products

If your dynamic block’s primary query returns no results (e.g. Recently Viewed for a new visitor, or Most Viewed on a store without enough pixel data), configure a fallback:
  • Select your dynamic product block.
  • Under Products to recommend, choose your primary query.
  • In the Fallback dropdown, select a secondary query to use when the primary returns nothing.

Liquid Variables

You can reference product data directly in your email or SMS copy using Liquid variables — useful for personalizing subject lines, body text, or SMS messages with specific product details. Two flow trigger products are exposed as top-level variables:
VariableDescription
{{ product_recently_viewed.title }}Title of the contact’s most recently viewed product (Browse Abandonment flows)
{{ product_recently_viewed.price }}Price of the contact’s most recently viewed product
{{ product_back_in_stock.title }}Title of the back-in-stock product (Back In Stock flows)
{{ product_back_in_stock.price }}Price of the back-in-stock product
Products inside a dynamic product block — regardless of query type (Recently Viewed, Most Viewed, Best Selling, Back in Stock, Recently Added) — are addressed by the block’s ID and product index:
VariableDescription
{{ dynamic_products['<block_id>'][0].title }}Title of the first product in the named block
{{ dynamic_products['<block_id>'][0].price }}Price of the first product in the named block
{{ dynamic_products['<block_id>'][0].image_url }}Image URL of the first product in the named block
{{ dynamic_products['<block_id>'][0].button_url }}Product page URL for the first product in the named block
Replace <block_id> with the ID of the product block (e.g. u_content_shopify_product_1) and the index with the position of the product in the block.
Liquid variables for product blocks are only available in Privy Flows and require a matching dynamic product block to be present in the same email or SMS.

Add multiple products

To add more than one product to your block:
  • Click your product block to select it.
  • Click + Add New Product on the right side menu.
  • Search for and select the product you’d like to add, then press Select Products.
You can select and deselect as many products as needed by using the checkboxes in the product picker.

Customize the product block

The product block auto-populates with the selected Shopify product’s title, price, and primary image by default. The entire image and title area will direct the recipient to the associated product page in a new tab when clicked. You can further tailor your product block using the right side menu. Customize settings such as:
  • Number of products per row
  • Horizontal and vertical gaps
  • Product Details visibility
  • Image height
  • Font appearance
  • Add a button

Test your product block

Select Preview to review the email’s design in both desktop and mobile views. Click the Send Test Email button to ensure the content displays as expected in your inbox.

Product Blocks in Displays

Add the product block

To add a product block to your display:
  • Head to Displays.
  • Select an existing display that you’d like to edit, or create a new display.
  • Once you’re in the editor, hover over the elements on your display and click the blue plus sign to add a new element. Select the Product element from the menu.
  • Search for and select the Shopify product you’d like to feature from the menu on the right.

Customize the product block

  • Once you’ve added your product block, you can uncheck the boxes of any content that you do not want shown on your display.
  • To edit individual components of the product block, such as the button or the text, click directly on the component you want to edit and make all your changes to the settings on the right. Save.