Product & Catalog Management
Manage complex product catalogs, variants, and prices across regions and channels — with a headless data model built on Medusa and extended for marketplaces in Mercur. Mercur’s Product module is the core place where you define, enrich, and distribute all product data. From simple SKUs to complex multi-variant catalogs for B2B and marketplaces, you keep one clean product model that powers every storefront, vendor portal and integration.
How you manage products in Mercur
Give your team and partners flexible ways to create and maintain product data – without locking them into a specific frontend or vendor tool.
With the Product module, you can:
- Create and edit products directly in Mercur Admin – including titles, descriptions, media, categories, tags, and custom attributes.
- Define product options and variants (size, color, configuration, etc.) with automatic SKU handling and variant-level inventory.
- Configure region-specific pricing and price lists so that different markets, currencies and customer groups see the right price.
- Organize your catalog with collections, categories and tags to power navigation, filtering and merchandising.
- Connect products to inventory items and stock locations, keeping availability up to date across all storefronts.
- Extend product data with metadata via API – to model any business rule (B2B contracts, marketplaces, subscriptions and more).
- Onboard new products from vendors with configurable product request & approval flows (part of Mercur’s marketplace tooling).
.png)
Build custom marketplace with Mercur
Create your unique multi-vendor platform with our powerful, flexible marketplace solution that adapts to your business needs.
What the Product module delivers for your business
Flexible catalog structures
Support simple, multi-variant, multi-part and bundled products in one consistent data model. Add new product types without refactoring your storefronts.
Multi-region, multi-currency pricing
Serve different regions, currencies and customer groups from a single catalog. Price lists and customer group pricing make B2B and marketplace scenarios manageable.
Better discovery & merchandising
Use collections, categories, tags and attributes to power navigation, search and campaign landing pages — no need for a separate “catalog service”.
Marketplace-ready product data
Because the Product module is built on Medusa, all data is accessible through clean APIs. Any frontend (Next.js, Remix, native apps) and any integration (ERP, PIM, search) can work with the same product source of truth.
Developer-friendly headless model
Because the Product module is built on Medusa, all data is accessible through clean APIs. Any frontend (Next.js, Remix, native apps) and any integration (ERP, PIM, search) can work with the same product source of truth.
Medusa-compatibility
Everything compatible with Medusa platform
Core capabilities
Product data model
A modern product schema that covers everything from basic SKUs to rich catalog data:
- Product title, subtitle and long description.
- Unique handle used to generate SEO-friendly URLs.
- Product type, brand and tags for internal and external classification.
- Image gallery and thumbnails.
- Status flags (draft / published) for safe staging of new catalog entries.
- Rich metadata fields for custom attributes (e.g. technical specs, compliance data, B2B flags, marketplace attributes).
Variants & options
Model real-world products without workarounds:
- Define product options such as size, color, material or any property.
- Generate variants from option combinations, each with its own SKU, barcode, dimensions and weight.
- Control availability on variant level (e.g. some colors out of stock, others on backorder).
- Enable or disable variants without losing historical order data.
Supports advanced Medusa product types such as:
- Standard products without variants.
- Multi-variant products (e.g. apparel, electronics).
- Multi-part variants (built from several inventory items).
- Bundle products composed of other variants.
Pricing & price lists
Price once, sell everywhere:
- Base prices per currency and region.
- Price lists for campaigns, contract pricing and negotiated B2B deals.
- Special pricing per customer group (wholesale vs retail, partner tiers, key accounts).
- Temporary or scheduled price changes for promotions and sales.
All of this is exposed via APIs, so frontends and ERP/CPQ tools can rely on the same pricing logic.
Collections, categories & tags
Structure your catalog so customers can actually find what they need:
- Collections for campaigns, drops and curated sets (e.g. “Summer Flowers”, “New Arrivals”, “Top Sellers”).
- Categories to build site navigation and store hierarchy (flat or multi-level).
- Tags to power filters, search facets and internal segmentation.
Collections and categories are first-class entities in the Product module and can be managed directly in Mercur Admin or via API.
Inventory & availability integration
The Product module works hand-in-hand with Mercur’s inventory capabilities:
- Link each variant to one or more inventory items.
- Track stock across multiple locations and warehouses.
- Use reservations during checkout to prevent overselling.
- Configure backorder and pre-order behavior per variant or product.
This makes it possible to support complex scenarios like marketplace vendors with their own stock, or mixed central + drop-ship inventory.
SEO & content readiness
Headless does not mean “SEO last”:
- Clean URL handles generated from product data.
- Fields for SEO titles and descriptions exposed to your frontends.
- Multi-language support via metadata or external CMS integration.
Full content access through APIs so product pages can be rendered in any framework.
Build custom marketplace with Mercur
Schedule a guided tour of Mercur Marketplace tailored to your specific marketplace requirements. Connect with our team to discuss how we can help bring your marketplace vision to life.