Documentation / Catalog
Catalog
Imports, AI enrichment, pricing rules, categories and publishing.
The catalog pipeline has four stages: import, enrich, price, publish. Nothing skips a stage, and only the last one is visible to customers.
Imports are resumable runs
An import is a run with state, not a request. The runner leases a batch, records progress, and can be paused and resumed. A supplier that starts erroring mid-run pauses the run instead of losing the products already imported.
| Run state | Meaning |
|---|---|
idle | No run in progress. |
running | A batch is leased and being processed. |
paused | Stopped deliberately or by repeated supplier errors. Resumable from the same cursor. |
done | The cursor reached the end of the selected category. |
AI enrichment
Supplier titles and descriptions are written for supplier marketplaces, not for your brand. Enrichment rewrites them — title, description, bullet attributes — and always writes to the staged copy so the original supplier text stays available for comparison.
Enrichment consumes creative credits from your plan. The credit cost of a run is shown before you start it.
Pricing rules
Rules are evaluated in a fixed order, so the outcome is predictable:
- Start from supplier cost plus the supplier’s shipping cost for the market.
- Apply the category multiplier, if the product’s category has one.
- Apply the market multiplier.
- Enforce the margin floor — a product that cannot clear it is flagged rather than published at a loss.
- Apply the rounding rule (for example, always end in
.99).
Use Simulate to run the whole chain against real staged products before saving. It reports the resulting price, absolute margin and margin percentage per product.
Categories
Supplier taxonomies are mapped onto your storefront categories once. Every future import from that supplier category inherits the mapping, so mapping work does not repeat.
Publishing
Publishing is explicit and reversible. Unpublishing removes a product from the storefront and the search index but keeps its history, so existing orders that reference it stay intact.
Inventory and cost sync
Stock and cost changes flow back from suppliers on a schedule. A product that goes out of stock upstream is marked unavailable on the storefront; a product whose cost rises above your margin floor is flagged for review rather than quietly sold at a loss.
Something wrong or missing on this page? Tell us — documentation corrections are treated as bugs.