Drag-and-drop product blocks

The drag-and-drop editor empowers you to quickly add and configure product blocks to your messages for seamless product showcases, without the need to create custom Liquid code.

Requirements

Requirement	Description
eCommerce recommended events	eCommerce recommended events provide standardized data schemas for key behavioral events that occur before and after an order is placed. These events will eventually replace the legacy Braze purchase event and will become the standard for tracking commerce-related behavior. eCommerce recommended events are required for dynamic product blocks. eCommerce recommended events are currently in early access. Contact your Braze customer success manager if you’re interested in participating in this early access.
eCommerce Canvas templates	The eCommerce recommended events support pre-built templates, including eCommerce Canvas templates designed for essential use cases such as abandoned browsing, abandoned carts, and order confirmations. If you plan to implement any of these essential eCommerce use cases using the eCommerce Canvas templates, you must use or follow the provided Canvas template.
Braze catalog	You need to create a Braze catalog that includes the following fields, which will be used in your product block configuration: product_title product_url variant_image_url

Types of drag-and-drop product blocks

Product block	Purpose	Use cases	Availability
Dynamic	Personalize your messaging with a showcase of products based on customer interactions by using eCommerce recommended events and catalogs within our eCommerce Canvas templates.	Abandoned browse Abandoned cart Abandoned checkout Order confirmations	Available in Canvas only.
Static	Personalize products using only the data stored in a Braze catalog or catalog selection.	Perfect for showcasing new product launches or category-specific offerings.

Product block content configuration

Each block type has different content configurations.

Product fields

In the Product Fields section, select your product block type, then toggle on the fields you’d like to include for each product. Each field is pulled from different sources based on the type of product block you select.

Dynamic product block

Product field	Source
Variant image	Catalogs
Product title	Catalogs
Button for product URL	Catalogs
Price	eCommerce Recommended event property
Quantity	eCommerce Recommended event property

Static product block

Product field	Source
Variant image	Catalogs
Product title	Catalogs
Button for product URL	Catalogs
Price	Catalogs

Layout options

Use layout options to customize how your products display within your product block.

Option	Description
Product orientation	Choose how the image and product fields within the block are oriented.
Alignment	Adjust the alignment of the text fields and button within the block.
Max products per row	Display up to three products per row, up to 12 products total for static product blocks, and up to 24 products total for dynamic product blocks.
Product spacing	Set the spacing between products.

Global email style settings

Global email style settings allow you to apply consistent styling to your emails within Braze. This means you can define specific styles—such as fonts, colors, and button designs—that will automatically apply to all your emails.

How global email style settings work with product blocks

Existing styles for paragraphs and buttons will automatically apply to the text and button elements within the product block. This means that any formatting you have set for paragraphs and buttons will be used consistently in your product block, maintaining a cohesive look throughout your email.

Setting up product blocks

Catalog setup

To use drag-and-drop product blocks, you need to set up a Braze catalog that includes specific field values. These fields will be used in your product block configuration. Make sure your catalog includes the following fields:

Field	Description
product_title	The title of the product.
product_url	The URL where customers can view or purchase the product.
variant_image_url	The URL for the variant image.

Get a jumpstart by working off this sample Product Catalog, which includes the required fields.

Creating product blocks

This guide will walk you through the steps to create, test, and ensure the functionality of a dynamic or static product block using our email drag-and-drop editor.

Step 1: Create an email campaign or email Canvas step

Dynamic product block

Create a new Canvas that uses one of the available Braze templates for your specific use case:

• Abandoned Browse
• Abandoned Cart
• Abandoned Checkout
• Order Confirmations

For detailed instructions on creating your eCommerce Canvases, refer to eCommerce use cases.

Static product block

Create a drag-and-drop email campaign, action-based Canvas, or template that has a drag-and-drop email Message step.

Step 2: Add a product block

• dynamic product block
• static product block

Step 3: Configure product fields

Select which product fields should be shown in the product block. Select Apply Settings after each change to see updates in the editor.

You can also customize the text before your Liquid tags. For example, you can prepend a dollar sign ($) for an item’s price or update the term for quantity to “amount” or another preferred label.

Step 4: Configure layout settings

Change the layout options to update how products display within your product block, and make sure to select Apply settings after each change.

Step 5: Preview and test your message

• dynamic product block
• static product block

After you’re done creating your message and confirming it looks like expected, you’re ready to send!