Selections

Learn how to create and use selections with your catalogs.

Selections are groups of data that can be used to personalize a message for each user in your campaign. When you use a selection, you’re essentially setting up custom filters based on specific columns in your catalog. This could include filters for brand, size, location, date added, and more. It gives you control over what you’re showing to users by allowing you to define criteria that items must meet first.

After creating a catalog, you can further reference your catalog data by incorporating selections in your Braze campaigns or recommendations.

Things to know

• You can create up to 30 selections per catalog.
• You can add up to four filters per selection.
• Selections are great for refining recommendations from Braze catalog data. If you’re looking for inspiration, check out About item recommendations for example use cases.

Creating a selection

To create a selection, do the following.

1. Go to Catalogs and select your catalog from the list.
2. Select the Selection tab and click Create Selection.
3. Give your selection a name and optional description.
4. For Filter Field, select the catalog column you want to filter by. String fields with more than 1,000 characters cannot be selected for filters.
5. Finish defining your filter criteria by selecting the relevant operator (for example, “equals” or “does not equal”) and attribute.
6. In the Sort type section, determine how results are sorted. By default, results are returned in no particular order. To specify sorting by a specific field, turn off Randomize Sort Order and specify the Sort Field and Sort Order (ascending or descending).
7. In the Results limit section, enter the maximum number of results, up to 50.
8. Click Create Selection.

Liquid in selection results

Using any Liquid in catalogs, such as custom attributes and custom events, can result in different results returned for each user in your selection.

Using selections in messaging

After creating your selection, personalize your messages with Liquid to insert the filtered items from that catalog. You can have Braze generate the Liquid for you from the personalization window found in message composers:

1. In any message composers that support personalization, click to open the personalization window.
2. For Personalization Type, select Catalog Items.
3. Select your catalog name.
4. For Item selection method, select Use a selection.
5. Select your selection from the list.
6. For Information to Display, select which fields from the catalog should be included for each item.
7. Click the Copy icon and paste the Liquid wherever it needs to go in your message.

Use case

Let’s say you own a meal delivery service and want to send a personalized message to your users who have specific meal preferences based on their most recently viewed food category.

Using a catalog with your meal delivery service’s information for the meal name, price, image, and category of the meal, you can create a selection to recommend three meals based on a user’s most recently viewed category.

To use this catalog and selection in a campaign, use the Add Personalization modal in the message composition section of building a campaign. In this example, we’ve selected the catalog with your meal delivery service’s information, and the selection for meal recommendations based on the most recently viewed category. This allows us to display the meal name and price. To further build your message, you can use the selection to also add an image of the first recommended meal.

For example, say you have a user whose most recently viewed category is “Chicken”. Using the set personalization and a Content Card campaign, you can send three meal recommendations that include chicken for this user.

Using the same personalization, you can also send three meal recommendations for a user whose most recently viewed category is “Beef”.