Product Data

If your store doesn’t use a platform we integrate with directly—such as Shopify, WooCommerce, or Shoptet—you can still enable AI-powered product recommendations by providing a product feed in one of the supported formats.

Supported Feed Formats

We support feeds in the following formats:

• XML (recommended)
• JSON
• CSV

A feed is a URL that provides a structured file (in one of the formats above) containing up-to-date data about your products. It usually includes all your products and their key details.

For example: > https://yourstore.com/feeds/products.xml

You can typically export these feeds from:

• Your internal inventory or e-commerce system
• Google Merchant Center
• Meta Commerce Manager (Facebook)
• Other tools that support product data export

Required Fields

To enable basic product recommendations, your product feed must include the following information:

💡 Note: Your actual field names do not need to match the names shown above. However, this information must be present in your feed.

For example, a column called product_name or name is fine—as long as it contains the correct data.

Without this core data, the AI will not be able to generate any recommendations.

Recommended Fields for Better Results

Including additional fields significantly improves recommendation quality and allows the AI to answer more detailed customer questions.

⚠️ If a piece of information isn’t included in the feed, the AI cannot infer or guess it. Be as comprehensive as possible.

You can expose this information either as dedicated fields or include it within metafields (see the list of recommended fields below).

Product Tags

If your feed already labels products in a way your customers ask about—vegan, clearance, made in italy, prescription required—include those labels and tell us which field they live in. We map them to product tags, which the AI can use as an exact filter: asked for "something vegan", it narrows the catalog to tagged products instead of hoping the word appears in the descriptions.

A few things worth knowing before you decide what to send:

• Keep the list short and shopper-facing. Tags are most useful when there are a handful of them and each one names something a customer would say out loud. Your full category tree doesn't need to be tagged—the AI already reads categories and descriptions.
• Keep the spelling stable. Tags are matched exactly (case and spacing aside), so gluten-free and gluten free count as two different tags.
• They apply from the next sync. Tags become filterable once your catalog has synced with them.

Suggested Product Feed Schema

Use the schema below as a reference. You don’t need to follow it exactly, but structuring your data similarly will streamline integration and improve results.

Example Scheme

• Product Name
• Product URLs
• Variants (for each variant):
  • SKU (identifier)
  • Variant URL
  • Stock quantity
  • Can it be sold out of stock? (Yes/No)
  • Is it in stock? (Yes/No)
  • Short description
  • Long description
  • Price details:
    • Current price
    • Regular price (if available)
    • Is it on sale? (Yes/No)
  • Metafields — custom key-value pairs (also known as attributes)
  • Images:
    • Image URL
    • Alt text (optional)
    • Is it the primary image? (Yes/No)
• Collections/Categories (groups the product belongs to):
  • Collection name
  • Collection slug (URL-friendly name)
  • Collection URL (if available)
  • Short and long descriptions (optional)
• Product Metafields (custom key-value pairs at the product level)
• Product Tags (optional labels customers ask for by name — see above)
• Product Images:
  • Image URL
  • Alt text (optional)
  • Is it the primary image? (Yes/No)

If you’re unsure how to generate a compatible feed or want us to validate a sample, contact us for assistance.