Item Attributes are a great way to highlight important features of an Item, such as dietary preferences, spice level, or allergen warnings.
Creating Item Attributes in GXP
To create and configure Item Attributes:
- Go to your Property in GXP
- Navigate to Content Management > Item Attributes
- Click + Create New Item Attribute at the top
- Enter an "Internal Name" and "Display Name" names (e.g., "Allergy Information" or "Spice Intensity")
- Select the Multi-Select type so that Items can be lebelled with multiple Item Attribute Options (e.g., "Gluten, Dairy, Nuts" or "Mild, Medium, Hot")
- Click Save to start adding Item Attribute Options
- Add as many Options as needed, then click Save.
Example
A “Dietary” Item Attribute might include Options like:
- Vegan
- Vegetarian
- Meat
- Pescatarian
Assigning Attributes to Items
Once Item Attributes are created, you can assign them to specific menu Items:
- Navigate to Content Management > Items
- Use the search bar to locate the desired Item
- Scroll to the bottom of the Item page
- Click + Add Attribute, then select the relevant Item Attribute and its Option(s) to apply.
- Publish a Live Verion: Setup > Versions > click Add New Version > select Make Live and click Create
These attributes can now be used for filtering on the guest facing page.
How Attributes Display to Guests
On Guest Web ( browser-based ordering)
- If the “Display attributes filter to guests” setting is enabled in GXP > Outlet Settings, and at least one item in the Outlet has Item Attributes applied, a Filter button will appear at the top of the Outlet page.
- Clicking the button opens a side drawer that lists all available Attribute Filters (e.g., Dietary, Spice, Allergens).
- Guests can select one or more values within each filter (e.g., Vegan, Mild) to narrow down the item list.
Example:Selecting “Vegetarian” under the Dietary filter will update the Outlet menu to show only items tagged as Vegetarian.
Real-Time Feedback
- The Filter button displays a badge showing the number of active filter values.
- Items update in real time when the drawer is closed using “Apply”, the X, or by clicking outside the drawer.
In progress - Hide Unclassified Items Toggle
- The drawer includes a “Hide Unclassified Items” toggle.
This determines whether to show items that don’t have any attribute values related to the selected filters.
Example:If “Mild” is selected in the Spice filter, but Buffalo Wings has no Spice attribute:
- Toggle ON (Hide unclassified items): Buffalo Wings will be hidden.
- Toggle OFF (Show unclassified items): Buffalo Wings will still be displayed.
By default, unclassified items are shown.
Persistent While Browsing
- Filters remain active while the guest browses within the same Outlet.
- Filters are cleared when:
- A new Outlet is opened
- An order is successfully completed (except when using an Open Tab)