Roraima Vendor Guide
Options
What Options are for
Use Options when the buyer must choose between alternatives for the same product. For example, a short-term rental can offer breakfast as Included or Not included.
An option is not a separate product. It is a choice attached to the product being edited.
Menu path
Vendor Back Office → Listings and structures → Listings → select the listing you want to edit → Options
The first screen lists the options already attached to the product. Open an existing option or use the add control to create one.
Option list
The list is the starting point for creating, opening or removing an option. Use Forbidden combinations only when two or more option choices must not be selected together.
After opening an option, the editor contains two inner tabs: General and Variants.
General tab
Use General to name the option, choose how it appears to buyers and decide whether a selection is required.
Storefront name is the wording buyers see. Use Edit below Name when the customer-facing wording should differ from the internal name.
For a booking surcharge, enable Charge per night only when the modifier must be multiplied by the number of nights. Otherwise the modifier is applied once per booking.
Variants tab
Use Variants to create the choices available for the option. Each row can have its own position, name, price modifier and status.
Expanded variant controls can also provide an icon, weight modifier and earned-point modifier. These are optional and are not needed for a simple service choice.
Field reference
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Name | Identifies the option in the Vendor Back Office. | Enter an internal name that makes the option easy to recognise. | Required. |
| Storefront name | Sets the customer-facing option name. | Use Edit and enter the wording buyers should see. | Optional. |
| Vendor | Shows which vendor owns the option. | Review the displayed owner. | Read-only. |
| Position | Controls the option's display order. | Enter a lower or higher position to place it among the other options. | Optional. |
| Type | Controls how buyers choose a variant. | Choose Select box or Radio group. | Required. |
| Description | Provides customer-facing explanatory text. | Explain the choice when buyers need more context. | Optional. |
| Comment | Adds a note below the option. | Enter a short instruction or clarification for buyers. | Optional. |
| Required | Controls whether the buyer must select a variant. | Enable it when the product cannot be purchased or booked without a choice. | Optional. |
| Missing variants handling | Controls what happens when variants are unavailable. | Choose Display message or Hide option completely. | Use the behaviour that gives buyers the clearest result. |
| Charge per night | Controls how a booking surcharge is applied. | Enable it when the price modifier must be charged for every night. | Booking products only. Disabled means a one-time surcharge per booking. |
| Pos. | Sets a variant's order. | Enter the position for the variant. | Optional. |
| Name | Sets the customer-facing variant name. | Enter the choice buyers should see. | Required for each variant. |
| Modifier / Type | Adjusts the product price for the variant. | Enter the modifier and choose € or %. | Optional. Leave the modifier empty or zero when the choice does not change the price. |
| Status | Controls whether the variant can be selected. | Choose Active or Disabled. | Use Active for a choice that buyers may select. |
| Icon | Adds an image to the variant. | Select an image only when it helps buyers understand the choice. | Optional. |
| I’m uploading a HiDPI image | Marks an uploaded icon as high density. | Enable it when the selected icon is the HiDPI version. | Optional. |
| Weight modifier / Type | Adjusts weight for the variant. | Enter the modifier and choose Kg or %. | Optional; use it only when fulfilment depends on product weight. |
| Earned point modifier / Type | Adjusts earned points for the variant. | Enter the modifier and choose points or %. | Optional. |
Example: breakfast
- Create an option and set Storefront name to Breakfast.
- Choose Select box or Radio group.
- Open Variants.
- Add Included and Not included.
- Set each required variant to Active.
- Add a price modifier only if one choice costs more.
- Enable Charge per night only if that extra price is charged for every night.
Save the option
Use Save inside the option editor after completing General and Variants. Then return to the product and use its main Save action if the product page still has unsaved changes.
Fix common problems
If buyers see the internal name, add the intended Storefront name.
If a choice cannot be selected, confirm that its Status is Active and review Missing variants handling.
If a surcharge is too high on multi-night bookings, check whether Charge per night was enabled unintentionally.
Related guidance
See General for the product's core settings and Product configuration for the complete configuration sequence. For a product in Equipment and spaces by time or by use, the Duration or Tokens option that Roraima adds is described in Time and use.