Switch
The Switch option type allows users to toggle a setting on or off, typically represented by a slider or switch button on the product page. This is useful for settings or features that customers can choose to enable or disable.
Basic Option Settings:

1. Option Name
This is the internal name for the switch option within your app. It helps you organize and identify the option during setup but is not visible on the storefront.
2. Label on Product
This is the title displayed above the switch on the storefront product page. It helps customers understand what the switch controls or activates.
3. Label on Cart
This is the text shown on the cart summary, checkout, and order detail pages, next to the option value that the customer has selected. It should clearly describe the setting that was toggled.
4. Required Field
If this setting is enabled, customers must interact with the switch before proceeding to checkout. It’s useful for ensuring that customers actively make a choice.
5. Hide "Label on Product"
When enabled, this hides the label above the switch on the product page. This is useful if the label is not necessary or if the context is clear from other elements on the page.
6. Add-on Product
When enabled, this setting adds an additional charge to the product if the switch is turned on. It’s useful for optional features or upgrades that come at an extra cost.
7. One time charge
This setting allows you to modify how additional charges are applied to a specific option value. Normally, the extra charge for an option is multiplied by the quantity of the product purchased (e.g., an additional charge of $10 would become $50 if the quantity is 5). However, by enabling the "One time charge" feature, the extra charge will only be added once, regardless of the product quantity. This is useful when you want to apply a flat fee for certain options without scaling the charge with the number of items purchased.
8. Switch Value
The switch value represents the possible states of the switch (e.g., "On" and "Off"). This helps indicate to customers what the switch will enable or disable.
9. Default Status
This determines the initial state of the switch when the product page loads (e.g., "On" or "Off"). It sets the default behavior for customers, which can be altered before purchase.
10. Conditional Logic
This setting allows you to display the switch option only when certain conditions are met. It’s beneficial for creating a dynamic shopping experience, where certain options appear based on previous selections.
Advanced Option Settings:

1. Tooltip
This setting provides a brief explanation when customers hover over an information icon next to the switch. It’s helpful for offering additional context without cluttering the interface.
2. Help Text
This setting appears below the switch on the product page and provides more detailed instructions or information about the option. This is useful for ensuring customers fully understand what the switch does.
3. Price display type
Decide whether to show or hide the additional price on the slider interface.
4. Class Name
This allows you to assign a custom CSS class to the switch option, enabling you to style it according to your design preferences. It’s beneficial for maintaining a consistent visual style across your storefront.
Last updated