Pass-Through Catalog API Requirements

The tables below outline the Catalog API attributes required for retail integrations on DoorDash Marketplace.

Each vertical includes attributes that are mandatory, important, or recommended for approval.

Partners should review the attributes relevant to the primary categories of items they intend to publish.

Providing these attributes ensures accurate merchandising, search relevance, compliance validation, and customer experience quality.

Pets

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name (brand + name + variant + size)
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.name	Navigation Category Level 1	string	mandatory
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.subcategory.name	Product Category	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory	See Supported Attributes documentation
items[].product_attributes[variant]	Variant	string	mandatory	See Supported Attributes documentation
items[].size.details.product_specific_size_definition.value	Size	string	mandatory	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	mandatory	Unit description
items[].product_attributes[concerns]	Concerns	array[string]	mandatory	See Supported Attributes documentation
items[].product_attributes[flavor]	Flavor	string	mandatory
items[].product_attributes[ingredients]	Ingredients	string	mandatory
items[].product_attributes[short_description]	Short Description	string	mandatory
items[].description	Description	string	important
items[].product_attributes[activity]	Apparel Activity	string	important
items[].product_attributes[color_name]	Color	string	important
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[container_type]	Container Type	string	important
items[].product_attributes[days_of_return]	Days of Return	integer	important
items[].product_attributes[hex_code]	Color Hex Code	string	important	Hex value (e.g. #FFFFFF)
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	important
items[].product_attributes[occasion]	Occasion	string	important
items[].product_attributes[package_type]	Package Type	string	important
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[return_eligibility]	Return Eligibility	boolean	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[surface]	Surface	string	important
items[].product_attributes[swatch_image_url]	Color Swatch	string	important	URL
items[].product_attributes[warranty]	Warranty	string	important
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	recommended
items[].product_attributes[exclusive]	Exclusive	boolean	recommended
items[].product_attributes[item_limit]	Item Limit	integer	recommended
items[].product_attributes[limited_edition]	Edition	string	recommended
items[].product_attributes[restriction_types]	Restriction Type	array[string]	recommended	See Supported Attributes documentation
items[].product_attributes[theme]	Theme	string	recommended

Beauty

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.subcategory.name	Product Category	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory	See Supported Attributes documentation
items[].product_attributes[variant]	Variant	string	mandatory	See Supported Attributes documentation
items[].product_attributes[concerns]	Concerns	array[string]	mandatory
items[].product_attributes[ingredients]	Ingredients	string	mandatory
items[].product_attributes[color_name]	Color	string	mandatory
items[].product_attributes[benefits]	Benefits	string	mandatory
items[].product_attributes[skin_types]	Skin Type	array[string]	mandatory
items[].item_categorizations[].category.name	Navigation Category Level 1	string	important
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	important
items[].size.details.product_specific_size_definition.value	Size	string	important	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	important
items[].product_attributes[short_description]	Short Description	string	important
items[].description	Description	string	important
items[].product_attributes[activity]	Apparel Activity	string	important
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[days_of_return]	Days of Return	integer	important
items[].product_attributes[hex_code]	Color Hex Code	string	important	Hex format
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	important
items[].product_attributes[occasion]	Occasion	string	important
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[return_eligibility]	Return Eligibility	boolean	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[surface]	Surface	string	important
items[].product_attributes[swatch_image_url]	Color Swatch	string	important	URL
items[].product_attributes[warranty]	Warranty	string	important
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	important
items[].product_attributes[exclusive]	Exclusive	boolean	important
items[].product_attributes[item_limit]	Item Limit	integer	important
items[].product_attributes[limited_edition]	Edition	string	important
items[].product_attributes[restriction_types]	Restriction Type	array[string]	important
items[].product_attributes[color_family]	Color Family	string	important
items[].product_attributes[cosmetics_age_range]	Age Range	string	important
items[].product_attributes[cosmetics_brush_type]	Brush Type	string	important
items[].product_attributes[coverage]	Cosmetics Coverage	string	important
items[].product_attributes[drinks_form]	Formulation	string	important
items[].product_attributes[finish]	Cosmetics Finish	string	important
items[].product_attributes[formulation]	Formulation	string	important
items[].product_attributes[fragrance_family]	Fragrance Family	string	important
items[].product_attributes[fragrance_type]	Fragrance Type	string	important
items[].product_attributes[gender]	Gender	string	important
items[].product_attributes[hair_texture]	Hair Texture	string	important
items[].product_attributes[hair_type]	Hair Type	string	important
items[].product_attributes[scent]	Scent	string	important
items[].product_attributes[spf]	SPF	string	important
items[].product_attributes[theme]	Theme	string	recommended

Health

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.subcategory.name	Product Category	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory
items[].product_attributes[variant]	Variant	string	mandatory
items[].product_attributes[concerns]	Concerns	array[string]	mandatory
items[].product_attributes[benefits]	Benefits	string	mandatory
items[].description	Description	string	important
items[].item_categorizations[].category.name	Navigation Category Level 1	string	important
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	important
items[].product_attributes[body_part]	Body Part	string	important
items[].product_attributes[color_family]	Color Family	string	important
items[].product_attributes[color_name]	Color	string	important
items[].product_attributes[container_type]	Container Type	string	important
items[].product_attributes[cosmetics_age_range]	Age Range	string	important
items[].product_attributes[cosmetics_brush_type]	Brush Type	string	important
items[].product_attributes[coverage]	Cosmetics Coverage	string	important
items[].product_attributes[diaper_size]	Diaper Size	string	important
items[].product_attributes[disclaimer]	Legal Disclaimer	string	important
items[].product_attributes[exclusive]	Exclusive	boolean	important
items[].product_attributes[finish]	Cosmetics Finish	string	important
items[].product_attributes[flavor]	Flavor	string	important
items[].product_attributes[fragrance_type]	Fragrance Type	string	important
items[].product_attributes[gender]	Gender	string	important
items[].product_attributes[hair_texture]	Hair Texture	string	important
items[].product_attributes[hair_type]	Hair Type	string	important
items[].product_attributes[ingredients]	Ingredients	string	important
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[item_limit]	Item Limit	integer	important
items[].product_attributes[limited_edition]	Edition	string	important
items[].product_attributes[package_type]	Package Type	string	important
items[].product_attributes[pregnancy_test_type]	Pregnancy Test Type	string	important
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[restriction_types]	Restriction Type	array[string]	important
items[].product_attributes[scent]	Scent	string	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[short_description]	Short Description	string	important
items[].product_attributes[skin_types]	Skin Type	array[string]	important
items[].product_attributes[spf]	SPF	string	important
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.product_specific_size_definition.value	Size	string	important	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	important
items[].product_attributes[baby_formula_stage]	Baby Formula Stage	string	recommended
items[].product_attributes[baby_learning_skill]	Baby Learning Skill	string	recommended
items[].product_attributes[baby_weight_capacity]	Baby Weight Capacity	string	recommended
items[].product_attributes[battery_included]	Battery Included	boolean	recommended
items[].product_attributes[battery_life]	Battery Life	string	recommended
items[].product_attributes[battery_required]	Battery Required	boolean	recommended
items[].product_attributes[compatibility]	Compatibility	string	recommended
items[].product_attributes[connector_type]	Connector Type	string	recommended
items[].product_attributes[home_room_type]	Home: Room Type	string	recommended
items[].product_attributes[home_sheen]	Home: Sheen	string	recommended
items[].product_attributes[home_style]	Home: Style	string	recommended
items[].product_attributes[indoor_outdoor_use]	Indoor / Outdoor use	string	recommended
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	recommended
items[].product_attributes[theme]	Theme	string	recommended
items[].product_attributes[voltage]	Voltage	string	recommended

Office and Craft

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.name	Navigation Category Level 1	string	mandatory
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory	See Supported Attributes documentation
items[].product_attributes[variant]	Variant	string	mandatory	See Supported Attributes documentation
items[].size.details.product_specific_size_definition.value	Size	string	mandatory	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	mandatory
items[].product_attributes[short_description]	Short Description	string	important
items[].description	Description	string	important
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[container_type]	Container Type	string	important
items[].product_attributes[days_of_return]	Days of Return	integer	important
items[].product_attributes[hex_code]	Color Hex Code	string	important	Hex value (e.g. #FFFFFF)
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	important
items[].product_attributes[package_type]	Package Type	important	string
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[return_eligibility]	Return Eligibility	boolean	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[swatch_image_url]	Color Swatch	string	important	URL
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	recommended
items[].product_attributes[item_limit]	Item Limit	integer	recommended
items[].product_attributes[limited_edition]	Edition	string	recommended
items[].product_attributes[restriction_types]	Restriction Type	array[string]	recommended	See Supported Attributes documentation
items[].product_attributes[theme]	Theme	string	recommended

Home Goods and Home Improvement

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.name	Navigation Category Level 1	string	mandatory
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory
items[].product_attributes[variant]	Variant	string	mandatory
items[].size.details.product_specific_size_definition.value	Size	string	mandatory	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	mandatory
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[container_type]	Container Type	string	important
items[].product_attributes[days_of_return]	Days of Return	integer	important
items[].product_attributes[hex_code]	Color Hex Code	string	important	Hex value
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	important
items[].product_attributes[package_type]	Package Type	string	important
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[return_eligibility]	Return Eligibility	boolean	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[swatch_image_url]	Color Swatch	string	important	URL
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	recommended
items[].product_attributes[item_limit]	Item Limit	integer	recommended
items[].product_attributes[limited_edition]	Edition	string	recommended
items[].product_attributes[restriction_types]	Restriction Type	array[string]	recommended	See Supported Attributes documentation
items[].product_attributes[theme]	Theme	string	recommended
items[].product_attributes[voltage]	Voltage	string	recommended

Electronics

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.name	Navigation Category Level 1	string	mandatory
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory
items[].product_attributes[variant]	Variant	string	mandatory
items[].size.details.product_specific_size_definition.value	Size	string	mandatory	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	mandatory
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[connector_type]	Connector Type	string	important
items[].product_attributes[battery_required]	Battery Required	boolean	important
items[].product_attributes[battery_included]	Battery Included	boolean	important
items[].product_attributes[battery_life]	Battery Life	string	important
items[].product_attributes[voltage]	Voltage	string	important
items[].product_attributes[model_number]	Model Number	string	important
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	recommended
items[].product_attributes[item_limit]	Item Limit	integer	recommended
items[].product_attributes[limited_edition]	Edition	string	recommended
items[].product_attributes[restriction_types]	Restriction Type	array[string]	recommended	See Supported Attributes documentation
items[].product_attributes[theme]	Theme	string	recommended

Apparel

API Field	Attribute Name	Data Type	Priority	Notes
items[].merchant_supplied_item_id	Item ID	string	mandatory	Must be unique within business across all stores
items[].other_identifiers[UPC/GTIN/PLU]	UPC	array[object]	mandatory	identifier_type enum(UPC, PLU, NSC2, GTIN); identifier_value string
items[].name	Item Name - for concatenation	string	mandatory
items[].product_attributes[cx_facing_item_name]	Item Name - for customer view	string	optional	Overrides generated item name
items[].brand_info.name	Brand	string	mandatory
items[].images[].url	Photo URL	string	mandatory	At least one image required
items[].item_categorizations[].category.name	Navigation Category Level 1	string	mandatory
items[].item_categorizations[].category.subcategory.name	Navigation Category Level 2	string	mandatory
items[].item_categorizations[].category.subcategory.subcategory.name	Backend Category Level 3	string	mandatory
items[].product_attributes[product_group]	Product Group	string	mandatory
items[].product_attributes[variant]	Variant	string	mandatory
items[].size.details.product_specific_size_definition.value	Size	string	mandatory	Numeric value only
items[].size.details.product_specific_size_definition.description	Size Unit of Measurement	string	mandatory
items[].product_attributes[activity]	Apparel Activity	string	important
items[].product_attributes[color_name]	Color	string	important
items[].product_attributes[compatibility]	Compatibility	string	important
items[].product_attributes[container_type]	Container Type	string	important
items[].product_attributes[days_of_return]	Days of Return	integer	important
items[].product_attributes[hex_code]	Color Hex Code	string	important	Hex format
items[].product_attributes[is_private_label]	Is Private Label	boolean	important
items[].product_attributes[is_waterproof]	Is Waterproof	boolean	important
items[].product_attributes[occasion]	Occasion	string	important
items[].product_attributes[package_type]	Package Type	string	important
items[].product_attributes[product_form]	Product Form	string	important
items[].product_attributes[return_eligibility]	Return Eligibility	boolean	important
items[].product_attributes[shopping_preference]	Shopping Preferences	string	important
items[].product_attributes[swatch_image_url]	Color Swatch	string	important	URL
items[].size.details.dimensions.length.value	Item Length	number	important
items[].size.details.dimensions.length.unit	Item Length Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].size.details.dimensions.width.value	Item Width	number	important
items[].size.details.dimensions.width.unit	Item Width Unit of Measurement	string	important	enum(inch, ft, cm, m)
items[].product_attributes[disclaimer]	Legal Disclaimer	string	recommended
items[].product_attributes[item_limit]	Item Limit	integer	recommended
items[].product_attributes[limited_edition]	Edition	string	recommended
items[].product_attributes[restriction_types]	Restriction Type	array[string]	recommended	See Supported Attributes documentation
items[].product_attributes[theme]	Theme	string	recommended