Add Items, Options, Add-Ons, and Components
Items are what guests order. Options, add-ons, and components let managers capture variations and extra choices.
Quick Reference
| Setup Item | What It Controls | Example |
|---|---|---|
| Item | Main orderable product or service. | Club sandwich, extra towel, spa package. |
| Option | Required or optional item variation. | Size, temperature, preference. |
| Add-on | Extra item added to the order. | Sauce, side dish, upgrade. |
| Component | Item part used for structured configuration. | Bundle item or set component. |
| Single-price item | Standard item with one price or free status. | Coffee, towel request, fixed-price dish. |
| Variant item | Item with selectable prices or variants. | Small, medium, large. |
| Set item | Item made from required or optional components. | Set menu, bundle, package. |
| Upsell item | Revenue Booster item suggested from another item or cart. | Dessert add-on, bottle upgrade. |
| Availability | Whether guests can order it. | Active, inactive, sold out, operating hours. |
| POS IDs | POS mapping for items, variants, add-ons, and components. | Required when POS integration is active. |
Before You Start
- Catalogue and category should exist.
- Price, tax, surcharge, and POS behavior should be known.
- Guest-facing item photos and text should be approved.
Add an Item
- Open the catalogue.
- Choose the category or subcategory.
- Add a new item.
- Enter name, description, POS IDs if needed, tags, quantity limit, image, and availability.
- Choose the item type: single price, variant, set, or upsell when Revenue Booster allows it.
- Add options, add-ons, components, item-level fields, or item-level hours if the item requires them.
- Save the item.
- Test the item in the guest flow.
Review and Edit Items
Use the item list to confirm items are in the correct category or subcategory, review guest visibility, and spot POS validation warnings.
- Open the item list for the category or subcategory.
- Review item name, active state, price, and warning indicators.
- Open the item to edit descriptions, images, tags, availability, item type, and POS fields.
- Save changes.
- Retest the item from the guest link before publishing.
Images, Tags, and Visibility
- Upload approved item images and crop them so the item remains clear on mobile.
- Add multiple images only when they help guests make a choice.
- Use tags for guest-facing or staff-relevant item labels, such as spicy, vegetarian, popular, or seasonal.
- Hide an item from the catalogue when it should be retained for future use but not visible to guests.
- Use item discount settings only when the discounted amount or percentage has been approved.
Item Types
| Item Type | Use It For | What To Check |
|---|---|---|
| Single price | One price, or a free item. | Price, free state, POS ID, and availability. |
| Variant | Multiple selectable prices or variants. | Variant title, price, active state, POS ID, and alias. |
| Set | A structured bundle with components. | Set price, component choices, required selections, and POS fields. |
| Upsell | Revenue Booster suggestions. | Revenue Booster active state and linked master items. |
Options, Add-Ons, Components, and Fields
Use these item details when guests need more than quantity selection.
- Add-ons: Optional extra choices with names, prices, active state, order, and POS IDs.
- Components: Required or optional parts of a set item. Keep active components within the property's validation limits.
- Item-level additional fields: Extra item-specific guest inputs, such as preparation note, size instruction, or custom selection.
- Item-level operating hours: Availability windows for one item when it differs from catalogue or category hours.
Keep guest choices simple. If choices are unclear, guests may submit wrong orders and staff will need to contact them.
Review Item Setup
- Confirm price is correct.
- Confirm required options are clear.
- Confirm unavailable items are hidden or labeled according to policy.
- Confirm item operating hours do not conflict with catalogue hours.
- Confirm item POS IDs are valid when POS integration is active.
- Confirm variants, add-ons, and components have POS IDs where the POS requires them.
Troubleshooting
Item does not appear for guests
What you see: Staff saved an item, but guests cannot order it.
Do this:
- Confirm the item is active.
- Confirm the category and catalogue are active.
- Check item and catalogue operating hours.
- Confirm required price or setup fields are complete.
POS warning appears on an item
What you see: The item list or catalogue detail shows an invalid POS warning.
Do this:
- Open the item.
- Check POS IDs for the item, variants, add-ons, and components.
- Confirm the POS mapping with the property POS owner.
- Save and retest POS validation before taking live orders.
Guest cannot select required choices
What you see: Guest opens an item but cannot complete the required options or components.
Do this:
- Review variant, add-on, component, and item-level field setup.
- Confirm required choices have active options.
- Confirm set items do not exceed component validation rules.
- Test the item again in the guest flow.