Data Feed Specifications

Provide your product feed in a structured format so we can ingest, map and publish your catalogue efficiently across Price Pilot.

Supported File Formats

Format Supported Preferred Notes
XML Yes Yes Best for structured and nested data
CSV Yes Simple and widely supported
TSV Yes Good where commas appear in text
JSON Yes Supports nested structures

General Principles

  • Product data → SupplierProduct
  • Offer data → SupplierOffer
  • Separate content from pricing for scalability

Minimum Required Fields

Field Required Description
sku Yes Unique product identifier
title Yes Product title
product_url Yes Landing page
price Yes Price incl. tax
supplier_category_tree Yes An identifier that can be used to categorise your product

Product-Level Fields

Field Required Description
sku Yes Unique identifier
title Yes Product title
description Full description
product_url Yes Product page
image_url_0 Recommended Primary image
image_url_1–6 Additional images
thumbnail_url Thumbnail
mobile_url Mobile page
model_url Model/3D asset
video_url_0–2 Video URLs
supplier_category_tree Recommended Category path
supplier_category_id Recommended Category ID
product_type Recommended Product type
manufacturer Manufacturer
brand Recommended Brand
sub_brand Sub-brand
series Series
mpn Recommended Part number
gtin Recommended Global ID
gtin_type GTIN type
condition Product condition
adult Adult flag
certifications Certifications
energy_efficiency_class Energy class
age_group Age group
parent Variant grouping
custom_label_0–4 Custom labels
promo_id Promotion ID
promo_text Promotion text
short_title Short title
short_description Short description
usps Key selling points
seller_id Seller reference
delivery_weight Weight
delivery_length Length
delivery_width Width
delivery_height Height
country_of_origin Origin
language Language
keywords Search keywords
review_count Review count
average_rating Rating
cogs Cost
recommended_retail_price RRP
attributes Recommended JSON attributes

Offer-Level Fields

Field Required Description
price_tax Yes Price incl. tax
price_ex_tax Price excl. tax
tax_rate Tax rate
sale_price_tax Sale price
sale_price_ex_tax Sale excl. tax
sale_from Sale start
sale_to Sale end
discount Discount
savings Savings
postage_cost Recommended Shipping cost
postage_from Shipping min
postage_to Shipping max
courier Courier
delivery_from Delivery min
delivery_to Delivery max
dispatch_from Dispatch
stock_qty Stock quantity
stock_label Stock label
stock_lead_time Lead time
availability Recommended Availability
currency Recommended Currency

Attributes (JSON)

Provide structured attributes:

{
  "colour": "Black",
  "material": "Steel",
  "voltage": "18V"
}

Category Mapping

We use a taxonomy aligned to Google. Mapping to Google categories improves performance and onboarding speed.


Summary

Mandatory

  • SKU
  • Title
  • URL
  • Price
  • Category identifier
  • Image
  • Brand
  • GTIN/MPN
  • Category
  • Attributes

Last updated 7 April 2026