Picker

Order-Level Content → Menu → Picker

Overview

What is a Picker?

A picker is a higher level product concept that combines combos and/or items. On the example below, we have created a picker called “Impossible Whopper” which would be the higher level concept, then it would compile under it all the different options for an Impossible Whopper which can be:

the Impossible Whopper sandwich (“Just the Sandwich”)
the Impossible Whopper small meal (“Small”)
the Impossible Whopper medium meal (“Medium”)
the Impossible Whopper large meal (“Large”) .

Advantage of Pickers

This way, when guests navigates to the “Flame-grilled burgers” section, they see the “Impossible Whopper” picker instead of seeing the impossible whopper medium meal, the large meal and the menu item (sandwich only). When they click on the picker, they will choose between just the sandwich or the different meal sizes, as well as other aspects that can be configured.

Note: picker and picker aspects always refer to another Sanity document. They do not have their own PLUs because, they simply map the guest selection to a specific menu item (e.g. if a guest selects 6 nuggets and medium meal in the picker, the picker aspect will map to the ‘6pc nugget medium meal’ combo item).

Examples

Below, you can see the Impossible Whopper picker, which contains the Combo Size picker aspect.

Another example is the Chicken Nuggets picker below, which contains the Nuggets Pieces and the Nuggets Meal Size picker aspects.

Special-case examples

In case we want to link this picker to the whopper bacon and/or cheese MDS menu items, we would add a picker aspect with the “bacon, cheese, bacon & cheese” options;
In case we want guests to be able to add cheese and/or bacon to the item, but without making it a new item, we would not add this picker aspect - we would simply have these ingredients as modifiers. For more info on modifiers click here.

Editing Pickers

Name

This is the name of the picker that will show in the platform, so must be edited according to your marketing guidelines.

Internal Name

The name that will be displayed in Sanity - it will help you quickly identify and organize your pickers. For existing markets this should have been automatically populated and should not be changed

Image

This is the image that is shown for the picker.

Image Description

This will be the text for the alt attribute on the image.

The alt attribute is the HTML attribute used in HTML and XHTML documents to specify alternative text (alt text) that is to be rendered when the element to which it is applied cannot be rendered.

It is also important for SEO purposes, as this description is what allows search engines (like Google) to connect this image to a search. By adding the Plant-based Whopper description, there is a chance users will find this image in Google Images, which can lead to traffic in the platform

Description

This is the description for the picker once it is clicked on, highlighted in red below.

Picker Aspects

In the current example, the Picker Aspects of the Impossible Whopper Picker are:

Just the Sandwich
Small
Medium
Large

Picker Defaults

When you arrive to the picker page, one option will be pre-selected. In the example above, “Just the Sandwich” is already selected without user having to click on anything.

This will be what picker aspect options are initially set as default when guest accesses the picker. In order to set them as default, you need to click on ‘Add item…’ under Picker Defaults, choose the same picker aspects you have added on ‘Picker Aspects’ and choose the option you want to set as default for each picker aspect.

Picker Aspect Item Option Mappings

UI Pattern

To be deprecated

Quick Configs

These are options that the user can use to auto-populate a field. A great example of this is Tim Hortons coffee option Single Single and Double Double.

Options

Until now, we have just created names for our Picker Aspects:

Just the Sandwich
Small
Medium
Large

However, how does the system know that the user is selecting the Impossible Whopper Sandwich and not any other sandwich? More importantly, how does the POS recognize our selection?

We must map each picker aspect to an actual Combo or Item. Picker aspects themselves do not have PLUs. Instead, Items and Combos tend to have. So for the order injections to work we must link Picker aspects to Items and / or Combos.

This process needs to be followed for all the Picker Aspects and then you are all done!

Channel Exclusions

Need to show different items depending on the Service Mode Group (Pickup / Delivery) or the platform (Web, Mobile, Kiosk, Google Food Ordering)? This is the place where you can exclude items from being shown to the guests.

Other Selections

All the other selections you can make throughout the Items file have been grouped in this part of the guide to simplify.

Show in Static Menu will allow displaying the picker in the Static Menu, before a Service Mode or store is selected. This is the equivalent to your National Menu, but it does not mean all of the pickers are available for purchase for Delivery or Pickup, for example.
Is Real Meal? - This is for the Real Meals Campaign

Hide Calories will hide the calories of this item in the user flow
Hide Nutrition Legal Disclaimer will hide the nutrition legal disclaimer