diff --git a/packages/grafana-ui/src/components/Forms/Switch.mdx b/packages/grafana-ui/src/components/Forms/Switch.mdx index 8d1b1a92a9c..1e1936a26cc 100644 --- a/packages/grafana-ui/src/components/Forms/Switch.mdx +++ b/packages/grafana-ui/src/components/Forms/Switch.mdx @@ -5,7 +5,12 @@ import { Switch } from "./Switch"; # Switch -Used to represent binary values +### When to use + +`Switch` is a representation of an on-off state – like a light switch. So you can use `Switch` to toggle binary states. + +Switches trigger changes immediately. If your component should trigger a change only after sending a form, it's better to use either `RadioButtonGroup` or `Checkbox` instead. Furthermore, switches cannot be grouped – each `Switch` triggers an independent state. If you want multiple mutually exclusive choices, the `RadioButtonGroup` is the better option. To offer multiple choices within the same group or context which are not mutually exclusive, use `Checkbox` instead. + ### Usage