How to test scenarios
This guide explains how to test your Bloomreach scenarios to ensure they work correctly and deliver the expected results. Testing helps you verify that scenarios are reliable, effective, and aligned with your business goals.
You can test scenarios in three ways:
- Preview tab.
- Event triggers.
- "As live" email testing.
Preview tab
Use the Preview tab for:
- Check customer flow while building scenarios.
- Debug existing scenarios when data changes cause conditions to fail.
- Test non-event triggered scenarios.
What you see in preview
The Preview tab shows how many customers flow through each node.

View how many customers pass through each node.
When you start a scenario, a warning message shows the total number of affected customers.

The warning message shows the total number of affected customers before you start a scenario.
Why numbers might not match:
In complex scenarios with multiple triggers or actions, the flow count can appear higher than the warning message count. This happens because:
- Multiple triggers count each customer multiple times (even though both triggers won't fire simultaneously for the same customer).
- Multiple action nodes multiply the count.
Example: A scenario with 2 triggers and 2 action nodes per customer shows 16 affected customers in the warning message, even though only 4 customers actually enter the scenario.

A scenario with 2 triggers and 2 action nodes shows 16 affected customers.
Event triggers
When you build a triggered scenario, create a separate testing flow for test customers.

Create a separate testing flow to isolate test customers.
To set up even trigger testing:
- Add an event node with required attributes (filters, email address).
- Select the Allow scenario triggering checkbox.
- Use test customer data to trigger the flow.

Select Allow scenario triggering in the event node to enable test customer flow.
Advanced event testing
For more complex testing, specify Custom timestamp to make sure events occur in the correct order.

Use a custom timestamp to control event order during advanced testing.
Example: The Jinja snippet {{ time - 60 }} tracks an event 60 seconds before the current time.

The Jinja snippet sets the event timestamp.
“As live” email testing
Use the custom recipient setting to send all emails to yourself instead of sending them to customers. This helps you test complex scenarios that are difficult to test with simulated data.
WarningBloomreach sends you one email for every customer who enters the email node. If you don't filter your audience, you'll receive thousands of emails. Campaign events are still tracked to each customer's profile.
Prepare for testing
- Filter your audience to include only test customers (for example, create a test segment with 5-10 profiles).
- Check the audience size in the scenario warning message.
- Don't use this method without audience limits.
How it works
Set the scenario live for real customers, but deliver all emails to your configured address. Review the data afterward.
When you use proper audience filtering, this method acts as a safety net to prevent accidental sends during scenario development.

The custom recipient setting redirects all emails to your address while the scenario runs on your live audience.
Updated 13 days ago
