Browsing the Product Catalog

How buyers search, filter, and view wholesale-priced products in the portal.

The Product Catalog

The catalog is where your wholesale customers browse your products and add items to their cart. It's designed for efficiency — B2B buyers often know what they're looking for and need to find products quickly.

Product Grid Layout

Products are displayed in a responsive grid layout. Each product card shows:

  • Product image — Displayed at a configurable aspect ratio
  • Product title
  • Pricing — Retail price crossed out with the wholesale price shown prominently
  • Volume Pricing badge — If the product has active volume pricing tiers

The number of products displayed per page and the image aspect ratio can be configured by the merchant in the Portal Styling settings.

Collection Filtering

Buyers can filter the catalog by Shopify collections to narrow down the product list. Collections appear as a sidebar list or dropdown menu (depending on your portal layout settings).

When a buyer selects a collection, only the products in that collection are shown in the grid. This is especially useful for stores with large catalogs — buyers can quickly jump to the specific product category they need.

Searching for Products

A search bar at the top of the catalog allows buyers to search for products by name. The search is performed client-side for instant results — as the buyer types, the product grid filters in real-time without waiting for a page reload.

This makes finding specific products extremely fast, even in catalogs with hundreds of items.

Pagination

For stores with many products, the catalog uses cursor-based pagination to break the product list into manageable pages. Navigation controls (Previous / Next buttons) appear at the top or bottom of the catalog, depending on your configuration.

Cursor-based pagination is more reliable than traditional page numbering — it ensures buyers don't miss products or see duplicates, even if your catalog changes between page views.

Real-Time Wholesale Pricing

The most important feature of the catalog is the real-time wholesale pricing display. For every product, logged-in buyers see:

  • The original retail price — shown with a strikethrough line
  • The wholesale price — shown prominently in the active/accent color

The wholesale price is calculated in real-time based on the buyer's group memberships and the active pricing rules that apply to them. Different buyers may see different prices for the same product, depending on which customer groups they belong to and which pricing rules target them.

Product Navigation Links

As a merchant, you can customize how products are organized and navigated in the portal using Product Navigation settings. This lets you create custom navigation menus that link to specific collections or product categories, making it easy for buyers to find what they need.

The number of product navigation links you can create depends on your plan: 3 on Free, unlimited on all paid plans.