Product Groups (Collections)

Product Groups

Product groups are collections curated in the admin (Products → Product groups), e.g. "Hot deals" or "New arrivals". Fetch one group by slug and render its products as a band or grid.

const { data: group, error } = await client.catalog.getProductGroup('hot-deals', {
  locale: 'cs',
  currency: 'CZK',
});
if (group) {
  // { id, slug, type, name, description, items: ProductListItem[] }
}

• name and description resolve in the requested locale, falling back to the shop default language.
• items are standard ProductListItem objects (same shape as getProducts), so any product card component works unchanged.
• Disabled products are excluded automatically; an inactive or unknown slug returns a 404 SdkResult error, so render nothing in that case.

React hook

import { useProductGroup } from '@behio/storefront-sdk/react';

const { data: group } = useProductGroup('hot-deals', { locale: 'cs' });

Available since SDK 0.27.0.