Frequently asked questions (FAQ)
This page answers common questions about deploying and managing use cases in the Use Case Center.
Getting started
How can I implement a use case effectively?
The About Use Case Center guide provides detailed steps for running your use case from start to finish.
Where can I find a list of all use cases?
You can find all use cases on our website. You can also ask your CSM for the full list.
What use cases are coming next?
Contact your CSM for information about upcoming use cases.
How can I learn about the latest use case updates?
Newly added use cases display a New tag for six weeks after publishing. Use the New use cases tile on the Home page or the Tags filter on the All use cases page to filter for them.
Requirements
How do I map data for use cases?
Review the use case requirements article.
Can I check if my project meets the requirements without downloading the use case?
Yes, there are two ways to check:
- Hover over the use case tile. If your project meets all required conditions, a green Ready to use tag appears. This tag reflects required integration requirements only — some optional data requirements may still be unmet.
- Click Download the use case on the use case detail page. A Requirements page opens and lists all requirements with status indicators:
- Grey — your project doesn't meet an optional data requirement.
- Red — your project doesn't meet a required integration requirement.
Review the instructions on the Requirements page to understand what happens when you click Continue.
What are integration requirements?
Integration requirements are always mandatory. If your project doesn't fulfill them, downloading the use case isn't possible. These requirements can include email, SMS, MMS, browser push, and mobile push integrations, as well as a default mobile center.
What are optional requirements?
Data requirements—events, customer properties, and catalogs—are always optional. You're encouraged to check these before downloading so the use case pulls in your project's actual data structure. Learn more about how to meet the requirements.
You can still download a use case without meeting optional requirements. Unmet data items download with a recommended default structure, and you'll need to update them in the downloaded assets to match your project's data.
Why do I need to create a placeholder catalog for some use cases?
Some use cases—for example, Gamified banners—require a voucher catalog or another non-product catalog. When this applies, a special requirement appears under the Other requirements section on the Requirements page.
The use case references this catalog using Jinja so the catalog name in your project must exactly match the name specified in the use case instructions. To meet this requirement before downloading:
- Create a catalog using the exact name specified in the use case instructions.
- Download the use case.
- Replace the placeholder catalog reference in the Jinja code with your actual catalog once it's created.
- Delete the placeholder catalog from your project.
The Other requirements section flags when a use case needs a placeholder catalog before downloading.
How are requirements set up per use case?
Data requirements—events, customer properties, and catalogs—are always optional. You can download a use case even if you don't meet them.
If you don't meet a data requirement, the use case downloads with default best-practice data for that event, customer property, or catalog. You'll need to update those items in the downloaded assets to align with your project's data. Make sure to view all assets included in the use case after downloading.
Map at least the purchase (complete) and purchase (returned) events in data mapping. These events appear across many assets and are the most time-consuming to update later.
Download and access use cases
What happens if I download a use case without meeting the data requirements?
The use case downloads with default best-practice data for any event, customer property, or catalog that didn't meet the requirements. You'll need to update those items in the downloaded assets to align with your project's data.
Make sure to view all assets included in the use case after downloading. See the must-have data that unlocks 85% or more of use cases for your project.
What does the "Repeated use case" message mean?
This message appears when you've previously downloaded the same use case. You can open the latest version or download it again.
This message appears when you've already downloaded the same use case — you can open the latest version or download it again.
How can I access a use case I downloaded from the Use Case Center?
There are 2 ways to access a downloaded use case:
- Go to Use Case Center > Project Use Cases. Click the use case to see the active assets—for example, a scenario or weblayer—and the dedicated evaluation dashboard.
- Access the use case assets directly in the relevant section of the application. For example, use case scenarios are also available under Scenarios.
The first option is recommended because it keeps all related assets and the evaluation dashboard in one place
How can I see all the assets downloaded with the use case?
Go to Use Case Setup, click the three dots in the top-right corner, and select Show use case items. You can switch between the action steps view and a full list of all assets.
Select Show use case items to switch between the action steps view and a full list of all downloaded assets.
Manage use cases
How can I delete a downloaded use case from my project?
Go to Project Use Cases and select Delete for the chosen use case. This permanently removes all assets downloaded with the use case, including assets not visible on the Use Case Setup page.
Select Delete to permanently remove a use case and all its downloaded assets from your project.
How can I unlink downloaded assets from the use case folder?
You can keep just one part of the downloaded assets — for example, only the dashboard — or combine parts from multiple use cases.
- In Use Case Setup, click the three dots and select Show use case items.
- Click the three dots again and select Unlink all items from use case.
Select Unlink all items from use case to detach assets from the use case folder without deleting them.
After unlinking, the assets no longer appear in Project Use Cases but remain available in the relevant sections of your project — for example, under Scenarios or Dashboards. There's no visual or dependency link between them after unlinking, and you can delete some assets while keeping others. Identify where each asset is stored before you unlink. It isn't possible to re-link assets after unlinking.
Can I share a use case I built in my project?
Your use case can become publicly available to all Bloomreach users in the Use Case Center. Contact the team using the Missing a use case? option on the Home page or All use cases page. Your CSM can also help with this.
What should I do if I can't find a specific use case?
Use the search bar and filters within the Use Case Center to narrow the list. If you still can't find it, contact your CSM. If the use case doesn't exist yet, submit your idea using the Missing a use case? option on the Home page or All use cases page.
Troubleshoot
What if I encounter an error with an existing use case?
Contact support or your Customer Success Manager (CSM).
What do these errors mean?
property_name: The listed event attribute isn't mapped in Data Mapping. This error appears on the Use case setup page after downloading. To fix it, map the event attribute and download the use case again.mapped_event: The event isn't mapped in Data Mapping. This error appears on the Use case setup page after downloading. To fix it, map the event and download the use case again.- Voucher pool with name vouchers doesn't exist: A voucher pool or other non-product catalog required by the use case isn't present in your project. This error appears on the Requirements page before downloading. To fix it, create a dummy catalog with the exact name indicated in the error message.
These errors appear after downloading when event attributes or events aren't mapped in data mapping.
I can see the use case tile, but I can't open it.
Your project is missing a module required by this use case, such as Predictions, Webhooks, or AI Segments. Contact your CSM or Account Manager to acquire the module.
I can't access the next step in the use case.
Access depends on your role and permissions. Ask a user with the required access to help, or request an access update.
Can I find which data is needed for which use case?
This isn't possible for individual use cases. However, if you complete the Data Mapping items marked as Must have, you'll meet the data requirements for 85% or more of use cases.
Updated 2 days ago