---
title: "Product Catalog"
slug: "product-catalog"
updated: 2026-01-26T16:13:48Z
published: 2026-01-26T16:13:48Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

| **Field** | Description |
| --- | --- |
| `productSKU` | Unique identifier for the product |
| `productName` | Name of the product |
| `productPrice` | Base price of the product |
| `productURL` | URL of the product detail page |

---

#### 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.

## Related

- [eCommerce: Product Catalog](/ecommerce-product-catalog.md)