Developer DocsData Enrichment
Catalog Attributes
The 12 product fields Intempt reserves on a catalog item, and the 6 that are required for recommendations to work.
Catalog Attributes
A catalog item carries 12 reserved fields, of which 6 are required. Recommendations, product feeds and commerce personalisation all read this schema, so a feed missing a required field will not power them.
| Key | Type | Required | Example |
|---|---|---|---|
id | STRING | yes | SKU-12345 |
title | STRING | yes | Men's Air Runner 2.0 |
link | STRING | yes | https://store.example.com/products/air-ru... |
description | STRING | yes | Lightweight running shoe with breathable ... |
image_link | STRING | yes | https://cdn.example.com/images/air-runner... |
price | NUMBER | yes | 129.99 |
categories | ARRAY | no | [Footwear, Running, Men] |
category | STRING | no | Running Shoes |
inventory_quantity | NUMBER | no | 42 |
intempt_published | BOOLEAN | no | True |
updatedAt | TIME | no | Oct 14, 2025 16:02 PM |
createdAt | TIME | no | Oct 14, 2025 16:02 PM |
The required 6
Without all of these, an item cannot be shown as a recommendation, because there is nothing to render:
| Key | Why it is required |
|---|---|
id | Unique stable identifier for the item in your catalog (e.g., SKU or product ID). |
title | Customer-facing product name shown in listings and PDPs. |
link | Canonical public product detail page URL (HTTPS). |
description | Short marketing copy summarizing the product’s key features/benefits. |
image_link | Direct URL to the primary product image (JPG/PNG/WebP). |
price | Current selling price as a decimal number in store currency (no symbol). |
Types
| Type | Notes |
|---|---|
STRING | Free text |
NUMBER | Decimal, used for price and inventory_quantity |
ARRAY | List, used for categories |
BOOLEAN | Used for intempt_published |
TIME | Timestamp, used for createdAt and updatedAt |
Note both categories (an array) and category (a single string) exist. Use
categories for the full taxonomy path and category for the primary label.
Getting a catalog in
| Route | Use when |
|---|---|
| Shopify source | Your catalog is already in Shopify. Products sync with no feed to build |
| Product feed | You publish a feed we pull on a schedule |
| Catalog API | You push changes as they happen |
See Product Catalog Ingestion for the API, and Source taxonomy for what Shopify provisions.