---
updatedAt: 2026-08-01T09:24:23.000Z
agentTools:
  siteIndex: https://documentation.bloomreach.com/llms.txt
  projectIndex: https://documentation.bloomreach.com/discovery/llms.txt
---

# Multi-view catalog

For specific customer scenarios, Bloomreach might recommend a multi-view catalog implementation. A multi-view integration allows us to use a common base product catalog while changing some product display attributes for each customized view.

## Is a multi-view catalog appropriate for my site?

Here are a few scenarios in which a multi-view catalog can help.

1. **B2B ecommerce site**: if you change your pricing or product availability based on specific contract terms with other businesses, a multi-view integration allows you to pass the various product versions of a given product, and tell us which version to display to which views.
2. **Multi-brand site**: when a site has multiple brands that sell the same product but use different product names, a multi-view catalog enables Bloomreach to understand the various titles for a product and know which title to display to which user.

## View ID values

We have designed our multi-view system to accept most view ID values that you might need. A view ID, simply put, allows us to filter the catalog to only show the products and versions of products that you want a particular site visitor or subsite within your account to see. The view ID values you choose must be consistent across the pixel, product feed, and API. This is important for Bloomreach to properly associate product information and user behavioral information to optimize the appropriate view's ranking.

## Product Catalog

If your product catalog has more than one version of the same product, you can include more than one product entry with the same product ID (pid), then specify for each entry the `view_id` values to indicate which specific entry to display to which site visitors or subsites. Here is a truncated sample feed:

| pid   | Title                      | Price | view\_id        |
| :---- | :------------------------- | :---- | :-------------- |
| 12345 | Acme Beautiful Dress       | $300  | regular         |
| 12345 | Acme Beautiful Dress, sale | $220  | sale            |
| 12345 | Acme Beautiful Dress, VIP  | $200  | loyal\_customer |

In this example, Acme.com has three views of their product. Acme.com displays version 01 of the product on their regular site. When visitors land in their flash sales micro-site, they see version 02 at the discounted price of $220. Acme.com shows to their most loyal customers version 03 of the product, a VIP discounted version. Acme.com uses `view_id` values of `regular`, `sale`, or `loyal_customer` when calling Bloomreach, and Bloomreach returns the appropriate version of the product based on the view.

> 📘 Tips
>
> **1. Multiple view IDs**\
> You can add multiple `view_id` values in the feed for a given pid entry. Simply add the various `view_id` values in a comma-separated format to the `view_id` field.
>
> **2. Base catalog**\
> If you have a base catalog, which is a set of products that can be included for all views, let your Bloomreach representative know which view to set as the base view. Products marked as base products will be included whenever they match a page, regardless of the `view_id` passed. In the event that 2 versions of a pid match, one part of the base catalog and one view-specific variation, we return only the view-specific variation.

## Tracking Pixel

You must include the appropriate `view_id` value in the general Bloomreach tracking pixel for each user throughout the journey. This enables Bloomreach to leverage the `view_id` information to further optimize ranking on your site for specific views.

## API

The `view_id` parameter must be included in all API calls to allow Bloomreach to return the appropriate product details for a given view. If `view_id` isn't included in the API call, a default view of the product catalog can be used in the API response. Your Bloomreach representative can help you configure your default view.

## Bloomreach with multi-view catalogs

A Search catalog powered by a Bloomreach [item collection](https://documentation.bloomreach.com/data-hub/docs/item-collection) doesn't support multi-view catalog functionality. This applies to both new and existing implementations.

Use a standard Search [catalog integration](https://documentation.bloomreach.com/discovery/reference/format-your-data-product#views) if your implementation requires multi-view capability.