Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Order-Level Content → Menu → Picker

...

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 to compile the whopper medium meal (“MEDIUM”), the whopper large meal (“LARGE”) and the whopper single item (“À LA CARTE” = ALCcalled “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 “Whopper” “Impossible Whopper” picker instead of seeing the impossible whopper medium meal, the whopper large meal and the whopper menu item (sandwich only). When they click on the picker, they will choose between a large combo, a medium combo and the ALC product, and just the sandwich or the different meal sizes, as well as other aspects that can be configured.

Note

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 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

...

Document Fields

...

Title

...

Description

...

Notes

...

Image

...

Used By

...

Name

...

will show in the platform, so must be edited according to your marketing guidelines.

...

Internal Name

The name that will be displayed

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

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.

...

Tip

...

titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Best Practices Tip

Remember choosing a picture without a background will look better, remove noise, and turn the guests' focus to the actual purchase 🍔 🍟

Image Description

This will be

...

the text for the alt

...

attribute

...

on the image

...

.

Expand
titleWhat is the alt attribute?

The alt attribute is

...

Status
titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Description

...

This describes the picker. Feel free to see examples from other markets for inspiration

...

Status
titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Picker Aspects

...

This is an aspect of the picker that can be changed or modified. Please add choose all aspects that apply by clicking on ‘Add item…’ under Picker Aspects

...

Status
titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

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 (wink)

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.

Note

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

Info

Make sure to add a picker default so that there’s always an option already selected for users. You will see that a minimum of a one picker default is required in Sanity

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.

...

add asterrix

...

Status
titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Image Added

Tip

You should see here all the picker aspects you added previously - from the options, you must choose one

Note

The default selection’s price will be shown in the Menu page (for a specific selected restaurant) and it needs to be the first one sorted in the list. Therefore, picker option with * always needs to be the first one

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 🤷‍♂️

Image Added

Picker Aspect Item Option Mappings

Warning

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

...

Note: in EMEA, we rarely use this feature

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

UI Pattern

...

Select 'Parallel' to see our recommended UI. Feel free to change it and test it by looking at the frontend if you think it makes sense, but please be consistent across pickers

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

.

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

...

Note: in EMEA, we rarely use this feature

...

Status
titleUnknown Attachment

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Options

...

Everything we would like to include in the section.If we have picker aspects we would have to map each item to each picker aspect response. Example: Picker Aspect Combo Size ( options: A la Carte, Small,Medium and Large). Picker options: Picker aspect A la Carte-> Bacon Cheeseburger item, Picker aspect Small-> Bacon Cheeseburger Meal Small, Picker aspect Medium-> Bacon Cheeseburger Meal Medium, Picker aspect Large-> Bacon Cheeseburger Meal Large. This will help us know when a user selects one or the other picker aspect to know what item to link it to.

...

  • Each has its own unique PLU

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Channel Exclusions

...

Here we can specify if we do not want this picker to be available on a certain platform/channel

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Show Static Menu

...

This adds the picker to the static menu that allows the user to see a default menu without having to first select a store

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

...

Depreciated

...

These are fields that we have used in the past. We keep these for old versions of the site that could be cached and still used

...

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Status
titleUnknown Attachment

Set Up

...

**Pickers with Duplicate Options

Pickers can also have multiple options of the same combo, this is so that it can be ordered “forwards and backwards”

Pickers Contain Multiple Options of the Same Combo

 

...

.

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.

Info

If you are wondering, we did not invent these complex systems, that is just how POS (Point of Sales) work 🤓

Tip

to know more about PLUs check the 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

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

...

 

Info

Unused Information

You might see additional fields in this document that are not part of this guide. Please disregard them as they are not needed for your Menu setup.