How to create room service catalog widgets
Overview
Widgets are a product configuration option within the room service catalog feature.
Widgets allow guests to customize products of their room service orders in the guest app, such as selecting a pizza size or choosing ingredients for a salad. Using widgets enhances the guest ordering experience by offering flexibility and control over their selections.
This article explains the two types of widgets (single choice and multiple choice) and how to set up each one.
Widgets can be used in both the regular catalog (which you must use for the on-demand booking system) and the advanced catalog (which you must use for the PRO booking system.
Before getting started
Before adding a widget, make sure you:
- Have access to Content > Services > Room service in the CMS.
- Have created a room service and its catalog.
- Decide whether to use a single choice or multiple choice widget.
- Prepare the name, description, and options for the widget in all languages.
Step-by-step guide
Step 1: Understand the types of widgets
There are two types of widgets:
- Single choice widget. This widget allows guests to select only one option from a list. For example pizza size, a specific meat doneness.
- Multiple choice widget. This widget allows guests to select more than one option from a list, up to a set maximum number of choices. This is useful for creating custom items like a salad or a hamburger with various ingredients.
[
Step 2: Create a widget
Option 1: Create a single choice widget
A single choice widget allows guests to select only one option from a list, such as meat doneness.
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to add a widget to.
- A screen will open with the edits you can make to the product. Click the Add widget button (this button is in the Product configuration section in the bottom left corner).
- Choose the single choice widget option. You can use a template or create a custom widget from scratch.
- Enter the widget’s name and a brief description. To add translations, enter the text in all available language fields.
- Add all available options by clicking the Add option button.
- Enter a name and price for each option. For translations, add the name in all language fields.
- From this screen, you can also switch to the other type of widget at the top by selecting the desired option.
- Click Save.
You must fill in all fields (name, description, option names and prices) to save the widget. Otherwise, you won't be able to save changes.
Editing a widget
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to edit.
- A screen will open with the edits you can make to the product.
- Go to the Product configuration section (in the bottom left corner) and search for the widget you want to edit.
- Click the Edit icon (pencil icon) next to the widget you want to modify.
- Edit the widget content as needed.
- Click Save.
Deleting a widget
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to edit.
- A screen will open with the edits you can make to the product.
- Go to the Product configuration section (in the bottom left corner) and search for the widget you want to delete.
- Click the X icon next to the widget’s name to remove it.
- Click Save.
Option 2: Create a multiple choice widget
A multiple choice widget allows guests to select more than one option from a list, such as ingredients for a salad or hamburger.
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to add a widget to.
- Click the Add widget button.
- A screen will open with the edits you can make to the product. Click the Add widget button (this button is in the Product configuration section in the bottom left corner).
- Choose the multiple choice widget option. You can use a template or create a custom widget from scratch.
- Enter the widget’s name and a brief description. To add translations, enter the text in all available language fields.
- Add all available options by clicking the Add option button.
- Enter a name and price for each option. For translations, add the name in all language fields.
- Define mandatory settings ****by activating the Mandatory options switch:
- Free options: Enter the number of free options guests can choose before being charged.
- Minimum: Enter the minimum number of options guests must select. For example, if a salad has 15 ingredients and the minimum is set to 3, guests must choose at least 3 ingredients.
- Maximum: Enter the maximum number of options guests can choose. For example, if a salad has 15 ingredients and the maximum is set to 3, guests can only select up to 3 ingredients.
- Click Save.
You must fill in all fields (name, description, option names and prices and mandatory options) to save the widget. Otherwise, you won't be able to save changes.
Editing a widget
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to edit.
- A screen will open with the edits you can make to the product.
- Go to the Product configuration section (in the bottom left corner) and search for the widget you want to edit.
- Click the Edit icon (pencil icon) next to the widget you want to modify.
- Edit the widget content as needed.
- Click Save.
Deleting a widget
- Go to Content > Services > Room service.
- Hover the cursor over the room service box and click Edit.
- Select the Catalog tab.
- Click the Edit icon next to the product you want to edit.
- A screen will open with the edits you can make to the product.
- Go to the Product configuration section (in the bottom left corner) and search for the widget you want to delete.
- Click the X icon next to the widget’s name to remove it.
- Click Save.
Need further assistance?
If you have additional questions or require further assistance:
- Contact us via live chat
- Send a ticket to our Support team
- Visit STAY Academy, our training platform.