Create and manage Dynamic categories

This guide will walk you through the process of creating and starting to use a Dynamic category. Here is an overview of the entire process:

Summary of the Dynamic category creation process

Summary of the Dynamic category creation process

Before you begin

Feature scope: Dynamic categories are linked to a Catalog. You can create and manage them from any site level.

Permissions

  • Only users with the “Category User” Role assigned to them on any management level higher than Site in User Management can access Dynamic category management to create or modify Dynamic categories.
  • Only users with the Catalog Feed Developer or Catalog Reindexing IAM Roles can trigger the feed indexing to sync Dynamic categories to the catalog.

1. Create a new Dynamic category

  1. To create a Dynamic category, go to Setup > Dynamic category management in your Bloomreach Dashboard.
  1. Click on the “+ New dynamic category” button at the top right of the screen. You will see the category creation wizard, where you can configure your new category.
  2. Start by giving your category a name and choosing the Catalog to which it should be added. Next to it, you will also see all the sites powered by the selected Catalog for which the Dynamic category will be available.

Dynamic categories and the Catalog

Dynamic categories become part of your product catalog through indexing. They work and affect search results just like feed-originated categories.

Important: One Dynamic category can only be linked to one Catalog.

2. Select category paths

Select the paths associated with your category using the Category path(s) dropdown. To add more paths, click Add category path.

The path list displays the category ID and category name followed by its full path

The path list displays the category ID and category name followed by its full path

Your Dynamic category is added to your site’s category hierarchy structure under all the selected parent paths.

🚧

  • If no path is selected, the new category will be added to the root level by default.
  • You can select up to 10 paths for a Dynamic category.

Note that the products added to the Dynamic category will become part of all the selected parent categories after Indexing (if they were not part of those categories already).

3. Add products to the category

Populate your category with desired products. You can add products to your new category manually or through conditions.

Add products through conditions

This method lets you set rules to automatically add products to a category. The category updates itself as new products meet these rules.

Define conditions to add matching products:

  1. Select Define conditions under Add products. This opens the Configure conditions setup.

  2. Choose how you want to match the conditions for each product:

    • Match ALL of the following: Products must meet all the conditions you set. (AND operator)
    • Match ANY of the following: Products must meet at least one condition you set. (OR operator)
  3. Click + Add condition to add a conditional rule based on different product attributes.

  4. Click + Add condition again to add more rules. For numeric attributes, additional operators are available for targeted range control.

    • is equal to: The product attribute value must match the exact input value.
    • is greater than or equal to: The product attribute value must be greater than or equal to the input value.
    • is less than or equal to: The product attribute value must be less than or equal to the input value.
    • matches range: The product attribute value is more than or equal to the minimum value and less than or equal to the maximum value.
  5. Once you’re satisfied with the conditions, click Apply conditions. This will make the matching products appear in the bottom panel.

Add products manually

This method lets you manually upload specific products in bulk to your category. This gives you full control over which products appear. Note that the category will not update automatically if you add products manually.

Follow the steps given below to add products manually:

  1. Select Add specific products under Add products.

  2. Click + Add products. This opens a modal to start adding products.

  3. You can add products in 2 ways -

    • Copy & Paste PIDs: Copy and paste up to 10,000 product IDs (PIDs) from your catalog. Separate them with commas, spaces, or pipe symbols.

    • Upload CSV: Upload a CSV file that contains valid PIDs.

  4. Select the desired method and click Add or Upload after adding the products. The added PIDs will appear, and the matching products will be displayed in the bottom viewing panel.

4. Save the category

After you add products, you can review them in the bottom viewing panel (Category preview) to finalize your selection. Here are some details about the preview panel:

  • The products in the preview are not ordered or ranked, and their order can differ between sites. Use the site menu at the top right corner to switch between sites.
  • If you added products manually, the preview will only show the first 950 products.

After reviewing the products inside the preview panel, Save your category from the button on the top right.

You can then see the new Dynamic category listed on the Dynamic category management page with the status Indexing pending. Note its unique Category ID for passing in the API call to display the category on your site.

📘

Under the Search or Merchandising Standard packages, one Catalog can only have up to 150 Dynamic categories at a time.

To get unlimited access to Dynamic categories, contact your Bloomreach representative and upgrade to the Search or Merchandising Premium package.

5. Index Dynamic categories

Dynamic categories work just like feed-originated categories because Bloomreach integrates them into your feed through the feed indexing process.

A Dynamic category can get indexed when:

All new, modified, and deleted Dynamic categories will be picked up during each indexing and updated in that catalog feed accordingly.

🚧

Run indexing

Indexing can be a time consuming and resource-heavy process, especially for large catalogs.

We encourage you to group your Dynamic category changes and only run the indexing when necessary.

Refer: Service Quotas for Feed Indexing

After indexing, the Dynamic categories will behave just like feed-originated categories. They will be visible on the All categories page, in your site's categories hierarchy, in Autosuggest (if Categories are searchable), and as a Facet value under the Category filter. Global Rules and Global Category Ranking Rules will apply to them as well. They also become ready to be merchandised and displayed on your website.

Indexing from Dynamic categories management

To trigger the Indexing process from the Dynamic categories Management tab, click on the Start indexing button on the top right of the homepage.

🚧

If you do not see the button (or it is locked), you would need the required User Permission Role mentioned above to run indexing.

Select the catalog for which you want to run the indexing and start it.

The process can be triggered only for one catalog at a time. Note that only the catalogs with any pending changes of Dynamic categories to be indexed will be available in the dropdown.

Once the category starts indexing, its status will show as Indexing in the Dynamic categories list. Once indexing is successfully completed, its status will change to Ready to use.

Modify or delete Dynamic categories

Existing Dynamic categories are listed on the Setup > Dynamic category management tab in your Dashboard.

Catalog selector

Using the Catalog Select dropdown, you can choose from all the product catalogs available for that account. The list will only display the Dynamic categories associated with the selected catalog.

Category ID

The Category ID is a unique identifier for your Dynamic category. Dynamic categories will always have an ID with the prefix brg_dyn_, which can help you distinguish them from feed-originated categories.

The Category ID is important because:

  • It must be passed in the Pixels for collecting tracking data.
  • It should be passed in the Product & Category Search API to fetch the Dynamic category for using it on your site.

Status

This column displays the status of your Dynamic category based on the stage of Indexing it is on. Given below are the possible category statuses:

  • Indexing pending: The Dynamic category is new or has changes that have not yet been reflected in the catalog.
  • Indexing: The indexing process for the catalog of which the Dynamic category is part is currently in progress.
  • Processing: The indexing process is completed, and the catalog is up to date. Other processes are running to make the category available for merchandising.
  • Ready to use: The Dynamic category is up to date in the Catalog, available for merchandising, and ready to be used on your site.

Modify Dynamic categories

To modify the details or rules of a Dynamic category, hover over the desired category from the list and click the Edit button that appears on the right side.

📘

Any changes to a Dynamic category will only be reflected in the feed and become ready to use after running the indexing process.

Delete Dynamic categories

To delete a Dynamic category, hover over the desired category from the list and click on the Dropdown arrow next to “Edit” that appears on the right side.

Click Delete and confirm the deletion on the pop-up that appears.

After deletion, it will be instantly removed from the Dynamic categories management and All Categories pages, but to delete it from the feed, you must run the indexing for the associated catalog.

Any ranking rules associated with the deleted category will still be available, but you can’t create new rules for that category.