> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md).

# Product Catalog Field Requirements

To have your products appear in areas where partners can see and interact with them, your catalog must include accurate and complete data in key fields. If you're also working with sellers through [retailer seller partnerships](/brand/what-would-you-like-to-learn-about/seller-program/beta-seller-for-retailers/im-a-retailer/seller-explained-for-retailers.md), then there are additional fields that become mandatory. Any product missing a required field may be excluded from Marketplace surfaces like the Product Marketplace and Mobile App.

## Catalog fields list

Every product catalog field is listed below under its requirement level with guidelines on how to populate the field correctly. Once you're done adding the correct fields to your catalog file, make sure it follows the [Product Catalog Best Practices](/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) before you [upload the catalog to impact.com](/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).

{% hint style="warning" %}
**Warning**: When filling out the fields in your catalog file, avoid placeholders like `TBD` or `N/A`, inconsistent formatting, and leaving critical fields empty.
{% endhint %}

<details>

<summary>Mandatory fields</summary>

These fields are <mark style="color:red;">**always required for all product catalogs and program types**</mark>. Products missing these fields may be excluded from Marketplace surfaces like the Product Marketplace and Mobile App.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>CatalogItemId</td><td>Enter the unique identifier for the item within the catalog, such as a SKU or ASIN.</td><td>Prevents duplicate records, supports reliable updates, and simplifies troubleshooting.</td></tr><tr><td>Product Name</td><td>Use clear, specific names so your products are easy to find in search results, such as <code>Men's Running Shoes, Blue, Size 10</code>.</td><td>Improves search accuracy and sales.</td></tr><tr><td>Description</td><td>Provide meaningful, concise product descriptions.</td><td>Gives partners and shoppers the context they need.</td></tr><tr><td>Product URL</td><td>Use a valid URL that leads to a live product details page (not a generic landing page).</td><td>Sends traffic to the correct page and reduces bounce rates.</td></tr><tr><td>Image URL</td><td>Use a valid URL that points to a high-resolution image hosted on a reliable server.</td><td>Builds trust and improves click-through and conversion rates.</td></tr><tr><td>Stock Availability</td><td><p>Include one of the following product availability statuses:</p><ul><li><code>InStock</code></li><li><code>OutOfStock</code></li><li><code>BackOrder</code></li><li><code>PreOrder</code></li><li><code>LimitedAvailability</code></li></ul></td><td>Avoids promoting unavailable items and shows accurate availability.</td></tr><tr><td>Price (Original/Current)</td><td>Include both values when applicable, especially for discounted items. Only products priced above $2.00 USD appear on <a data-footnote-ref href="#user-content-fn-1">Marketplace surfaces</a>.</td><td>Shows value clearly and avoids pricing confusion.</td></tr><tr><td>Currency</td><td>Include the 3-digit ISO 4217 currency code for the product price.</td><td>Displays prices correctly and avoids regional pricing errors.</td></tr></tbody></table>

</details>

<details>

<summary>Mandatory fields for Seller</summary>

When working with sellers through [retailer seller partnerships](/brand/what-would-you-like-to-learn-about/seller-program/beta-seller-for-retailers/im-a-retailer/seller-explained-for-retailers.md), <mark style="color:red;">**these fields are required in addition to the**</mark> [<mark style="color:red;">**Mandatory fields**</mark>](#mandatory-fields). Products missing these fields cannot be correctly mapped to a seller.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Seller Name</td><td>Enter the name of the <a data-footnote-ref href="#user-content-fn-2">3P seller</a> offering the product, or for a <a data-footnote-ref href="#user-content-fn-3">1P product</a>, enter the retailer (your) name.</td><td>Identifies who is making the offer, often shown under 'Sold by'.</td></tr><tr><td>Retail Strategy</td><td><p>Enter one of the following options:</p><ul><li><a data-footnote-ref href="#user-content-fn-3"><code>1P</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>WHOLESALE</code></a></li><li><a data-footnote-ref href="#user-content-fn-4"><code>3P</code></a></li><li><a data-footnote-ref href="#user-content-fn-4"><code>MARKETPLACE</code></a></li></ul></td><td>Identifies whether this is a 1P or 3P offer.</td></tr><tr><td>Manufacturer</td><td>Include the brand of the product.</td><td>Improves search results and powers the <em>Top Product Brands</em> filter partners use.</td></tr><tr><td>Category</td><td>Use consistent, clear product categories so your products appear in the right category.</td><td>Helps products appear in relevant searches and category views.</td></tr></tbody></table>

</details>

<details>

<summary>Strongly recommended fields</summary>

These fields are not enforced unless noted otherwise, but products missing these fields perform worse in search, filtering, and partner discovery. <mark style="color:red;">**Including these fields is recommended for every catalog**</mark>, regardless of whether you work with partners, sellers, or both. Fields marked with an asterisk (\*) become mandatory in the circumstances described.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Manufacturer<strong>*</strong></td><td>Include the brand of the product. <strong>*Mandatory</strong> when working with sellers through <a href="/brand/what-would-you-like-to-learn-about/seller-program/beta-seller-for-retailers/im-a-retailer/seller-explained-for-retailers.md">retailer seller partnerships</a>, and whenever you provide an MPN.</td><td>Improves search results, powers the <em>Top Product Brands</em> filter partners use, and makes MPN values unambiguous.</td></tr><tr><td>Category</td><td>Use consistent, clear product categories so your products appear in the right category.</td><td>Helps products appear in relevant searches and category views.</td></tr><tr><td>GTIN<strong>*</strong></td><td>Provide a valid, unique Global Trade Item Number (GTIN) for the product, for example its UPC or EAN. <strong>*GTIN Type is mandatory</strong> whenever you provide a GTIN.</td><td>Deduplicates your products and matches them to the same item listed elsewhere.</td></tr><tr><td>GTIN Type</td><td>Enter the standard the GTIN follows: <code>EAN</code>, <code>UPC</code>, <code>ISBN</code>, or <code>JAN</code>. Mandatory whenever you provide a GTIN.</td><td>Tells impact.com how to read and validate the GTIN.</td></tr><tr><td>MPN<strong>*</strong></td><td>Provide the Manufacturer Part Number (MPN) assigned by the product's manufacturer. <strong>*Manufacturer is mandatory</strong> whenever you provide an MPN.</td><td>Identifies products that have no GTIN, and keeps compatible parts and variants matched correctly.</td></tr><tr><td>Is Parent</td><td>Indicate whether the SKU is the parent for a set of variants.</td><td>Groups variants correctly and improves browsing.</td></tr><tr><td>Parent SKU</td><td>If the product is a variant, enter the SKU of its parent product.</td><td>Connects each variant to the correct parent product.</td></tr><tr><td>Condition</td><td>Enter the condition of the product: <code>New</code>, <code>Used</code>, <code>Refurbished</code>, <code>OEM</code>, or <code>OpenBox</code>.</td><td>Tells partners and shoppers what condition the product is in.</td></tr></tbody></table>

</details>

<details>

<summary>Optional fields</summary>

These fields aren't required, but they give partners and shoppers more detail about your products. Include the fields that apply to your products.

### Identify and categorize products

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Seller ID</td><td>Enter the internal unique identifier of the <a data-footnote-ref href="#user-content-fn-2">3P seller</a> offering the product.</td><td>Identifies which products belong to each 3P seller.</td></tr><tr><td>Parent Name</td><td>If the product is a variant of another item, enter the name of that item family.<br>Format: Alphanumeric<br>Example: <code>Space Shuttles</code></td><td>Names the product family a variant belongs to.</td></tr><tr><td>ASIN</td><td>Enter the 10-character Amazon Standard Identification Number (ASIN) for the product in the Amazon Marketplace.<br>Format: Alphanumeric<br>Example: <code>B0ABC12345</code></td><td>Identifies the product in the Amazon Marketplace.</td></tr><tr><td>Is Bundle</td><td>Enter whether the product is part of a custom bundle that you created.<br>Format: Text<br>Valid values: <code>TRUE</code>, <code>FALSE</code></td><td>Identifies products that are part of a custom bundle.</td></tr><tr><td>Multipack</td><td>If the product is a multipack you defined (not one defined by the manufacturer), enter the number of items in the multipack.<br>Format: Numeric<br>Example: <code>4</code></td><td>Shows how many items a merchant-defined multipack contains.</td></tr><tr><td>Labels</td><td>Enter a list of labels, separated by commas.<br>Format: Text<br>Example: <code>AMZN_SELLER</code>, <code>WALMART_SELLER</code>, <code>BESTBUY_SELLER</code></td><td>Categorizes the product in impact.com. For example, labels can identify products that are part of Seller programs when you add products to a Seller program manually.</td></tr><tr><td>Sub-Category</td><td>Use Sub-Category for an additional category, separate from the one in the Category field. Its value doesn't need to fall under the main category.<br>Format: Text<br>Example: <code>Space Shuttles</code></td><td>Lets you classify the product under a second category, separate from its main category.</td></tr><tr><td>Business</td><td>Enter the type of business the product applies to.<br>Format: Text<br>Example: <code>B2B</code></td><td>Shows the type of business the product is for.</td></tr><tr><td>Original Format Category ID</td><td>If the product already exists on impact.com, enter its category ID from the original product catalog upload.<br>Format: Alphanumeric<br>Example: <code>EK307</code></td><td>Links the product to its category in the original catalog upload.</td></tr><tr><td>Original Format Category</td><td>Enter the product's category breadcrumb trail.<br>Format: Breadcrumb<br>Example: <code>Children > Toys > Space > Space Shuttles</code></td><td>Records the product's category path.</td></tr><tr><td>Advertiser Format Category</td><td>Enter the product's category breadcrumb for the Product Marketplace.<br>Format: Breadcrumb<br>Example: <code>Children > Toys > Space > Space Shuttles</code></td><td>Sets the category path the product uses in the Product Marketplace.</td></tr></tbody></table>

### Add content and links

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Bullets</td><td>Enter a list of short statements about the product's features, separated by commas.<br>Format: Text<br>Example: <code>Crew of 7, flew 25 flights</code></td><td>Highlights the product's key features.</td></tr><tr><td>Additional Image URLs</td><td>Enter a list of up to 10 additional URLs that point to images of the product, separated by commas.<br>Format: Text<br>Example: <code>https://impact.com/SSE-1.jpg,https://impact.com/sse-2.jpg</code></td><td>Shows more images of the product.</td></tr><tr><td>Mobile URL</td><td>Enter the mobile URL that points to the product.<br>Format: Text<br>Example: <code>https://mobile.impact.com/product/space-shuttle-endeavor</code></td><td>Points mobile shoppers to the product.</td></tr></tbody></table>

### Describe product attributes

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Gender</td><td>Enter the gender the product is intended for.<br>Format: Text<br>Valid values: <code>Male</code>, <code>Female</code>, <code>Unisex</code><br>Example: <code>Female</code></td><td>Shows who the product is intended for.</td></tr><tr><td>Age Group</td><td>Enter the age group the product is intended for.<br>Format: Text<br>Valid values: <code>Newborn</code>, <code>Infant</code>, <code>Toddler</code>, <code>Kids</code>, <code>Adult</code><br>Example: <code>Toddler</code></td><td>Shows which age group the product is intended for.</td></tr><tr><td>Age Range Min</td><td>Enter the minimum age the product is intended for, in the unit you set in Age Range Unit.<br>Format: Numeric<br>Example: <code>14</code></td><td>Sets the lower end of the product's intended age range.</td></tr><tr><td>Age Range Max</td><td>Enter the maximum age the product is intended for, in the unit you set in Age Range Unit.<br>Format: Numeric<br>Example: <code>25</code></td><td>Sets the upper end of the product's intended age range.</td></tr><tr><td>Age Range Unit</td><td>Enter the unit for the age range.<br>Format: Text<br>Valid values: <code>Months</code>, <code>Years</code><br>Example: <code>Years</code></td><td>Sets whether the age range is in months or years.</td></tr><tr><td>Adult</td><td>Enter whether the product is intended only for adults.<br>Format: Text<br>Valid values: <code>TRUE</code>, <code>FALSE</code></td><td>Identifies products intended only for adults.</td></tr><tr><td>Colors</td><td>Enter a list of the product's colors in order of prevalence, separated by commas.<br>Format: Text<br>Example: <code>White, Blue</code></td><td>Shows the product's colors.</td></tr><tr><td>Material</td><td>Enter a list of the product's materials in order of prevalence, separated by commas.<br>Format: Text<br>Example: <code>Cotton, Nylon</code></td><td>Shows what the product is made of.</td></tr><tr><td>Pattern</td><td>Enter the pattern that appears on the product.<br>Format: Text<br>Example: <code>Pinstripe</code></td><td>Shows the product's pattern.</td></tr><tr><td>Size</td><td>Enter the size of the product, in the unit you set in Size Unit.<br>Format: Text<br>Example: <code>XS</code></td><td>Shows the product's size.</td></tr><tr><td>Size Unit</td><td>Enter the unit of measurement for the product's size.<br>Format: Text<br>Valid values: <code>Meters</code>, <code>Decimeters</code>, <code>Centimeters</code>, <code>Millimeters</code>, <code>Liters</code>, <code>Deciliters</code>, <code>Centiliter</code>, <code>Milliliter</code>, <code>Kilograms</code>, <code>Grams</code>, <code>Milligrams</code>, <code>Yards</code>, <code>Feet</code>, <code>Inches</code>, <code>Pounds</code>, <code>Gallons</code>, <code>Quarts</code>, <code>Pints</code>, <code>Ounces</code><br>Example: <code>Yards</code></td><td>Sets the unit for the product's size.</td></tr><tr><td>Weight</td><td>Enter the weight of the product, in the unit you set in Weight Unit.<br>Format: Numeric<br>Example: <code>3.14</code></td><td>Shows how much the product weighs.</td></tr><tr><td>Weight Unit</td><td>Enter the unit of measurement for the product's weight.<br>Format: Text<br>Valid values: <code>lb</code>, <code>oz</code>, <code>g</code>, <code>kg</code>, <code>mg</code><br>Example: <code>lb</code></td><td>Sets the unit for the product's weight.</td></tr><tr><td>Energy Efficiency Class</td><td>Enter the product's energy efficiency label.<br>Format: Text<br>Valid values: <code>G</code>, <code>F</code>, <code>E</code>, <code>D</code>, <code>C</code>, <code>B</code>, <code>A</code>, <code>A+</code>, <code>A++</code>, <code>A+++</code><br>Example: <code>B</code></td><td>Shows the product's energy efficiency rating.</td></tr><tr><td>Apparel Size</td><td>Enter the size of the piece of apparel.<br>Format: Text<br>Valid values: <code>XS</code>, <code>S</code>, <code>M</code>, <code>L</code>, <code>XL</code><br>Example: <code>XL</code></td><td>Shows the apparel size.</td></tr><tr><td>Apparel Size System</td><td>Enter the apparel size system.<br>Format: Text<br>Valid values: <code>US</code>, <code>UK</code>, <code>EU</code>, <code>DE</code>, <code>FR</code>, <code>JP</code>, <code>CN</code>, <code>IT</code>, <code>BR</code>, <code>MEX</code>, <code>AU</code><br>Example: <code>UK</code></td><td>Shows which sizing system the apparel size follows.</td></tr><tr><td>Apparel Size Type</td><td>Enter the apparel size type.<br>Format: Text<br>Valid values: <code>Regular</code>, <code>Petite</code>, <code>Plus</code>, <code>BigAndTall</code>, <code>Maternity</code><br>Example: <code>Petite</code></td><td>Shows the apparel's size type.</td></tr></tbody></table>

### Send custom data

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Text1, Text2, Text3</td><td>Enter any text data you want to send.<br>Format: Text<br>Example: <code>Limited edition</code></td><td>Lets you send custom text data.</td></tr><tr><td>Numeric1, Numeric2, Numeric3</td><td>Enter any numeric data you want to send.<br>Format: Numeric<br>Example: <code>42</code></td><td>Lets you send custom numeric data.</td></tr><tr><td>Money1, Money2, Money3</td><td>Enter any monetary data you want to send.<br>Format: Numeric<br>Example: <code>9.99</code></td><td>Lets you send custom monetary data.</td></tr></tbody></table>

### Add pricing and inventory details

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Unit Price</td><td>Enter the price per unit of the product.<br>Format: Numeric<br>Example: <code>14</code></td><td>Shows the product's price per unit.</td></tr><tr><td>Product Bid</td><td>Enter the bid value of the product.<br>Format: Numeric<br>Example: <code>3</code></td><td>impact.com uses the bid value when it generates the tracking link for the partner.</td></tr><tr><td>Manufacturing Cost</td><td>Enter the product's manufacturing cost. This amount excludes any payment to partners.<br>Format: Numeric<br>Example: <code>30</code></td><td>Records what the product costs to make.</td></tr><tr><td>Inventory</td><td>Enter the inventory count of the product.<br>Format: Numeric<br>Example: <code>250</code></td><td>Shows how many units of the product are in stock.</td></tr></tbody></table>

### Add availability dates

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Estimated Ship Date</td><td>Enter the estimated date to ship the product. Include this field if the product's Stock Availability isn't <code>InStock</code>.<br>Format: <code>YYYY-MM-DDThh:mm:ssZ</code><br>Example: <code>2020-09-15T14:30:00Z</code></td><td>Shows when the product is expected to ship.</td></tr><tr><td>Launch Date</td><td>Enter the date the product came to market. Include this field if the product's Stock Availability is <code>PreOrder</code>.<br>Format: <code>YYYY-MM-DDThh:mm:ssZ</code><br>Example: <code>2020-10-15T14:30:00Z</code></td><td>Shows when the product came to market.</td></tr><tr><td>Expiration Date</td><td>Enter the date the product will no longer be available.<br>Format: <code>YYYY-MM-DDThh:mm:ssZ</code><br>Example: <code>2020-12-15T14:30:00Z</code></td><td>Shows when the product stops being available.</td></tr></tbody></table>

### Add shipping details

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Field</th><th>How to populate it</th><th>Why it matters</th></tr></thead><tbody><tr><td>Shipping Rate</td><td>Enter the cost of shipping the product, in the same currency as the product. Enter <code>0.00</code> if the product has free shipping.<br>Format: Numeric<br>Example: <code>3.99</code></td><td>Shows the cost of shipping the product.</td></tr><tr><td>Shipping Weight</td><td>Enter how much the package will weigh when it ships, in the unit you set in Shipping Weight Unit.<br>Format: Numeric<br>Example: <code>30</code></td><td>Shows the weight of the shipping package.</td></tr><tr><td>Shipping Weight Unit</td><td>Enter the unit for the shipping weight.<br>Format: Text<br>Valid values: <code>lb</code>, <code>oz</code>, <code>g</code>, <code>kg</code>, <code>mg</code><br>Example: <code>lb</code></td><td>Sets the unit for the shipping weight.</td></tr><tr><td>Shipping Width</td><td>Enter the width of the shipping package, in the unit you set in Shipping Length Unit.<br>Format: Numeric<br>Example: <code>17</code></td><td>Shows the width of the shipping package.</td></tr><tr><td>Shipping Length</td><td>Enter the length of the shipping package, in the unit you set in Shipping Length Unit.<br>Format: Numeric<br>Example: <code>42</code></td><td>Shows the length of the shipping package.</td></tr><tr><td>Shipping Height</td><td>Enter the height of the shipping package, in the unit you set in Shipping Length Unit.<br>Format: Numeric<br>Example: <code>23</code></td><td>Shows the height of the shipping package.</td></tr><tr><td>Shipping Length Unit</td><td>Enter the unit for the package's shipping dimensions.<br>Format: Text<br>Example: <code>in</code></td><td>Sets the unit for the shipping width, length, and height.</td></tr><tr><td>Shipping Label</td><td>Enter any labels that need to be placed on the package.<br>Format: Text<br>Example: <code>Perishable</code></td><td>Flags labels that must go on the package.</td></tr></tbody></table>

</details>

{% hint style="danger" %}
**Important**: Meeting the mandatory requirements only gets your products onto Marketplace surfaces. To help them stand out and perform well once they're there, see [Product Catalog Best Practices](/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md).
{% endhint %}

## Additional requirements for Seller

When working with sellers through [Retailer Seller partnerships](/brand/what-would-you-like-to-learn-about/seller-program/beta-seller-for-retailers/im-a-retailer/seller-explained-for-retailers.md), your catalog must also contain the following:

* **All seller SKUs**: Every SKU that sellers will use in their Seller programs must appear in your catalog. If a seller lists a product on your site but the SKU isn't in your impact.com catalog, that product can't be tracked, attributed, or surfaced to partners.
* **All variant SKUs**: Include every variant of a product, not only the parent. For example, if a t-shirt is sold in 3 colors and 4 sizes, each of the 12 combinations must appear as its own row with its own SKU. Parent-only catalogs miss the specific product a shopper actually buys, which prevents accurate attribution.
* **All Buy Box contenders**: If multiple sellers offer the same product, include a row for each seller's offer, not only one row for the winning offer (i.e., include all buy box contenders, not just the buy box winner).

[^1]: The places where partners actually see and interact with your products, such as the Product Marketplace and Mobile App.

[^2]: A seller who lists and sells their own products on your marketplace independently.

[^3]: Products you purchase from a vendor and sell directly to customers as your own stock.

[^4]: Products listed and sold by outside 3rd-party sellers on your marketplace.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.