Personalization setup

Personalization blocks display targeted content to specific customer groups, segments, or cart rules. Use them to show different promotions, messaging, or content to different customer types on the same page.

Vocabulary

Targeted Block

A block that wraps the content targeted for specific customer groups, segments, or cart rules.

Group

(Adobe Commerce Customer Group) assigned to the customer.

Segment

(Adobe Commerce Customer Segment) that applies to the customer.

Cart Rule

(Adobe Commerce Cart Price Rule) that applies to the customer cart.

Configuration

Add this table to your document to configure the block:

targeted-block
segments	1, 2 (example)
groups	1, 3 (example)
cartRules	5 (example)
fragment	/path/to/fragment (example)
type	promotion-banner (example)

• segments: Comma-separated list of customer segment IDs that determine which customers can view the block. Optional.

• groups: Comma-separated list of customer group IDs that determine which customers can view the block. Optional.

• cartRules: Comma-separated list of cart rule IDs that determine which customers can view the block. Optional.

• fragment: The path to the fragment containing the content. If not specified, the last merged row of the block configuration must contain the content. Optional.

• type: The type of block to use for fallback chain creation. Only the first block that satisfies the conditions of each type is displayed. Optional.

How to enable and configure Personalization

Personalization blocks can be configured on each page through Document Authoring. Follow the step-by-step guide below to enable and configure Personalization:

Create customer segments, groups, or cart rules

You must first create the targeting criteria in Adobe Commerce Admin that will determine which customers see your personalized content.

1. Log in to the Adobe Commerce Admin.

2. Create customer segments, customer groups, or cart price rules as needed:

   • Customer Segments - Go to Customers > Segments and follow the user guide to create segments.
   • Customer Groups - Go to Customers > Customer Groups and follow the user guide to create groups.
   • Cart Price Rules - Go to Marketing > Promotions > Cart Price Rules and follow the user guide to create rules.

How to add and configure the Personalization block

You can configure each page to display personalized content by setting targeting criteria and optionally specifying a fragment path or block type.

1. Open the page where you want to display personalized content.

2. Create a new table in your document with the block name targeted-block.

3. Add configuration properties based on your targeting needs:

   Example: Target specific customer segments:

   targeted-block
   segments	1, 2

   Example: Load content from a fragment:

   targeted-block
   fragment	/path/to/fragment

   Example: Use fallback with block type:

   Create two blocks with the same type value. The first block (with conditions) displays when conditions are met, and the second block (fallback) displays otherwise:

   targeted-block
   cartRules	5
   type	promotion-banner

   Then add a fallback block with the same type but no conditions:

   targeted-block
   type	promotion-banner

   Specify a fragment

   If you don’t specify a fragment, the last merged row of the block configuration must contain the content to display.

Section metadata

Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional:

section-metadata
Style	light (optional)
Padding	medium (optional)
Margin	small (optional)
Column Width	30% (optional)
Gap	small (optional)

Learn more

See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options.