Large Assortment

Large Assortment Integration Schemas define the Product Catalog and Assortment file formats, uploaded by integrated partners, to be able to list large selections in non-restaurant venues.

Product Catalog files are NDJSON files uploaded at brand level, representing the variety sold across all brand's locations. Assortment files are JSON files uploaded at venue level, defining categories, sub-categories, products assigned to those, and store-specific attributes, such as pricing and stock.

Product Catalog

A Product Catalog file is an NDJSON file uploaded at brand level. Each line in the file is a Product object representing one product in the variety sold across the brand's locations. It is represented here as an array for portal rendering clarity.

The Product Catalog array

Properties

schema_versionstringenum: 1

Required. The schema version being used. Additional versions will be added in case of breaking changes.

external_idstring

Required. The external ID of the product, i.e., the ID of the product in the partner's system. Ensure that this ID is stable over time and is not reused — it should not represent different products over time. This ID helps map product data with assortment items.

name[object]

Required. The name of the product in different languages.

product_informationallOfallOf: 1 schemas

Required. Detailed product information including nutrition, ingredients, allergens, and display units.

description[object]

The description of the product in different languages.

gtin_barcodestringpattern: ^\d{8}$|^\d{12}$|^\d{13}$|^\d{14}$

The GS1 certified GTIN identifier of the product. Must be a valid GTIN (8, 12, 13, or 14 digits) with a valid GS1 check digit. Ensure that the GTIN is stable over time and is not reused — it should not represent different products over time.

venue_idstring

Identifier of the venue in which this product should only be available. When set, the product is scoped to a single venue instead of the entire brand.

image_urlstring

The URL of the image of the product.

alcohol_percentagenumberminimum: 0maximum: 100

Alcohol percentage for the product, where 5.5 means 5.5%. Note: This field triggers restrictions settings for age and delivery controls when the value is above zero.

Assortment

The root object representing a complete assortment for a venue on Wolt. Each assortment file maps 1:1 to a venue and contains categories, subcategories, listings, and store-specific attributes such as pricing and stock.

The Assortment object

Properties

metaobject

Required. Metadata about the schema version used by the document.

venue_idstring

Required. The venue ID on Wolt for which the assortment is being sent. Every store/location is represented as a venue on Wolt.

categories[object]

Required. The list of categories for this venue in the order in which they should be presented to the users.

assortment[Listing]

Required. The listing objects containing the operational attributes of products being sold. In the actual JSON file this is a map of listingId → Listing object, but it is represented here as an array for portal rendering clarity. See the example for the actual format.

picking_areas[object]

The picking areas for this venue. Each listing must appear in at most one picking area.