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.
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.
Another example is the Chicken Nuggets picker below, which contains the Nuggets Pieces and the Nuggets Meal Size picker aspects.
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.
Image
This is the image that is shown for the picker.
Best Practices Tip
Remember choosing a picture without a background will look better, remove noise, and turn the guest’s focus to the actual purchase 🍔 🍟
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
What is a Picker Aspect?
Picker Aspects are the different criteria a Guest can choose from to result in the combo or item which they would like to order.
Need for Picker Aspects
Picker Aspects are needed if you have defined a Picker previously. They can only be linked to Picker Documents
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 one option will be pre-selected. In the example above, “Just the Sandwich” is already selected without user having to make any click.
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.
You should see here all the picker aspects you added previously - from the options, you must choose one
The default selection’s price will be shown in the Menu page
While defaulting the biggest combo size might help sell higher tickets, defaulting the smallest and cheapest picker option will make your Menu look more attractive in the Menu page 🤷♂️
Picker Aspect Item Option Mappings
This is used to restrict a modifier from being used if the specified aspect is selected. For example, if guests pick a bacon and cheese whopper we will not let them modify the bacon or the cheese.
UI Pattern
to be deprecated right? Artiaga, Patricia
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.
If you are wondering, we did not invent these complex systems, that is just how POS (Point of Sales) work 🤓
to know more about PLUs check this FAQ Content FAQs
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
For easiness of explanation, all the other selections you can make throughout the Items file have been groupped in this part of the guide.
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? Artiaga, Patricia
Hide Calories will hide the calories of this item in the user flow
Hide Nutrition Legal Disclaimer will hide the nutrition legal disclaimer
**Pickers with Duplicate Options Artiaga, Patricia help here pls, didnt understand
Pickers can also have multiple options of the same combo, this is so that it can be ordered “forwards and backward”
Pickers Contain Multiple Options of the Same Combo
