Import data

AgenticLift
Ask about this Page
Copy for LLM
View as Markdown

Map legacy catalog fields to the AgenticLift schema and import your data.

Prepare your data

Before import, complete the following steps:

  1. Map legacy field names to the AgenticLift schema (for example: colour_hex to color, legacy_sku to product variant sku).
  2. Confirm the following are ready for Agentic Channel configuration:
    • The locale for your catalog (for example: en-US). This value is auto-populated from the Store settings during channel creation.
    • The Store key created during project settings configuration.
    • If Stripe is your payment service provider, the restricted secret key from your Stripe account. This is entered during Agentic Channel setup.
  3. Remove duplicates and consolidate variant SKUs under a shared item_group_id.
  4. Ensure all required attributes are populated.
Products with missing gtin, brand, image_link, or description are at high risk of being excluded from AI agent recommendation sets.

Import products

Use the Import API for catalogs exceeding 500 SKUs. For smaller catalogs, use the Merchant Center to import from a CSV file.

Group variants

Use a shared item_group_id for variants of the same product to prevent fragmented search results. For example, if a shoe comes in 10 sizes, all 10 must be grouped under one item_group_id. Otherwise, the AI agent sees 10 separate products, which reduces recommendation quality.

Price configuration

Prices must be embedded at the variant level and, if you use dedicated Channels, scoped to the distribution Channel. Currency must be USD for the US launch. For real-time price updates, use the Import API. These propagate to the Universal AI Feed within 15 minutes.