Product Catalog

Introduction

The Product Catalog is the central place where all products used in eCommerce features within Mapp are managed. It defines which products are available, which attributes they contain, and how product data is structured for consistent use across campaigns, automations, and transactional messaging.

By providing a fixed catalog structure with mandatory and optional fields, the Product Catalog ensures that product information is searchable, consistent, and ready for use in features such as recommendations, abandoned cart scenarios, and other eCommerce-related use cases.

Common Use Cases

• Reviewing which products are available for use across the eCommerce features

• Searching for specific products using a Product SKU or a key prefix

• Importing product data into Mapp to keep the catalog up to date

• Managing the Product Catalog structure, including mandatory and optional product attributes

Product Catalog Overview and Structure

The Product Catalog combines product data management with a predefined data structure that controls how products are used throughout the platform. Users access the Product Catalog via Administration > eCommerce > Product Catalog.

At a high level, the Product Catalog provides:

• Access to all products used in the eCommerce features

• A searchable product list based on Product SKU

• Manual product data import

• A fixed catalog structure with mandatory and optional product attributes

Product Catalog Structure

The Product Catalog structure defines all available product fields. Mandatory fields ensure that every product meets the minimum requirements for use in eCommerce features, while optional fields allow additional enrichment for more advanced use cases.

Mandatory Product Fields

Mandatory fields are required for every product in the Product Catalog.

Optional Product Fields

Optional fields extend product data and support additional use cases such as stock handling, localization, and custom product attributes.

These fields include, for example:

• Stock-related fields such as stockTotal and variant

• Media fields such as imageURL and zoomImageURL

• Product classification fields such as brand and category

• Localization fields for names, prices, URLs, and descriptions

• Custom attributes for additional, business-specific product information

Stock Handling Logic

The Product Catalog supports flexible stock handling through the use of stockTotal and variant fields:

• Either stockTotal or variant must be provided for a product.

• If only one of these fields is used, it becomes required.

• If both fields are provided, the sum of all values defined in variant overrides the stockTotal value.

This logic allows stock information to be managed either at a total product level or at a variant level, depending on business requirements.