Add Item Modifier Images directly through your menu
Prerequisites​
Integrated Modifier Images is a new DoorDash feature that enables Merchants to directly add and update modifier (option-level) menu photos on DoorDash. We have enhanced our Menu API to pull modifier photos directly from the source along, as we do for item-level images today.
In order to utilize:
- Merchants must already be using integrated images as this feature relies on image auto-linking.
- Merchants must be added to allowlist for Integrated Modifier Images by a DD technical account manager
Overview​
Photos are extremely important for Merchants on DoorDash as they are a primary driver for order conversion and AOV. Further, Merchants want consistency and accuracy in how their brand is portrayed across their stores on Doordash. Integrated Modifier Images allow Merchants to further increase their menu photo coverage and enhance the customer experience. We’ve seen as much as a 4% lift in customer conversion for merchants who have already adopted this feature.
This new feature includes two versions:
- An auto-approval version [Recommended] that will pull photos from the Mx’s POS integration, crop them to meet DoorDash specifications, upload them to your DoorDash store, and link the photo to all associated items on DoorDash.
- A manual-approval version that will pull photos from the merchant’s POS integration, then pass the images to our dedicated Photos team to approve the photos, crop them to meet DoorDash specifications, and link the photos to all associated items on DoorDash.
Get Started​
How?​
Start by reaching out to a DD Technical Manager or Employee to let them know you’re interested in the integrated modifier photos product. Once you’re enabled from the DD end, you’ll be able to begin testing by adding the additional field ‘original_image_url’ to the menu payload on an item-option level.
Auto Approval Flow​
When a menu update or ingestion is triggered our product will now pull in photo URLs from the Merchant, in addition to the rest of the menu data. If the system recognizes that the photo URL provided with a modifier is the same URL as the last menu update we will not ingest a new photo. If the system recognizes a new photo URL the product will:
- Automatically crop & ingest those photos to the Merchant’s business ID in our systems for all providers or businesses enabled for auto-approval.
- Once all photos are entered into DoorDash systems, a linking process is kicked off.
- This process utilizes the mapping of Item to PhotoURL from the POS menu payload to determine what photo needs to be linked to what item modifier.
Manual Approval Flow​
When a menu update or ingestion is triggered our product will now pull in photo URLs from the Merchant, in addition to the rest of the menu data. If the system recognizes that the photo URL provided with a modifier is the same URL as the last menu update we will not ingest a new photo. If the system recognizes a new photo URL the product will:
- Ingest the new photo
- Send the photos to DoorDash’s Photo team to be reviewed, enhanced, and approved or rejected within 5 business days
- Once the photos have been reviewed, an email will be sent to the Merchant notifying them of the status of their images.
- All approved images will be linked utilizing the mapping of the Item to PhotoURL from the POS menu payload to determine what photo needs to be linked to what item modifier.
URL Requirements​
- Http or https format
- No query parameters in url
- Ends in .JPG, .JPEG, or .PNG
- URL publicly accessible
Photo Specifications​
The DoorDash platform requires that photos meet certain criteria to display properly on the site. These requirements are as follows:
- 16:9 aspect ratio
- Max file size of 2MB
- JPG, JPEG, or PNG format
- Merchant’s photos must meet these guidelines if they would like to use auto-approval
If the file size or file format criteria are not met, this new feature will fail and no photo will be linked to the item.
For auto-approval, if a photo does not meet the aspect ratio requirements, DoorDash will crop the middle section of the photo to meet this requirement. This cropping is not ideal, so we suggest the Mx change the source photos in their POS system to meet this aspect ratio requirement so that no cropping is needed on the DoorDash end.
Implementation Details​
Integrated Modifier Images is not enabled by default for stores, given not all POS systems support this capability. To enable this functionality, please contact your technical account manager.
Technical Details - EXAMPLE MENU​
Below is a snippet of the menu payload with the new photo URL included on the Item Option Level for OpenAPI integrations.
{
"reference": "string",
"store": {
"merchant_supplied_id": "string",
"provider_type": "string"
},
"open_hours": [
{
"day_index": "MON",
"start_time": "13:00",
"end_time": "18:00"
}
],
"menu": {
"name": "string",
"subtitle": "string",
"merchant_supplied_id": "string",
"active": true,
"categories": [
{
"name": "string",
"subtitle": "string",
"merchant_supplied_id": "string",
"active": true,
"sort_id": 0,
"items": [
{
"name": "string",
"description": "string",
"merchant_supplied_id": "string",
"active": true,
"is_alcohol": true,
"is_bike_friendly": true,
"sort_id": 0,
"price": 0,
"base_price": 0,
"item_special_hours": [],
"extras": [
{
"name": "string",
"description": "string",
"merchant_supplied_id": "string",
"active": true,
"sort_id": 0,
"min_num_options": 0,
"max_num_options": 0,
"num_free_options": 0,
"min_option_choice_quantity": 0,
"max_option_choice_quantity": 0,
"min_aggregate_options_quantity": 0,
"max_aggregate_options_quantity": 0,
"options": [
{
"name": null,
"description": null,
"merchant_supplied_id": null,
"active": null,
"price": null,
"original_image_url": "string"
}
]
}
],
"tax_rate": "string",
"tax_category": "string",
"original_image_url": "string"...}
]
}
]
}