New in version 1.0.7.

_images/switch-on.jpg _images/switch-off.jpg

The Switch widget is active or inactive, like a mechanical light switch. The user can swipe to the left/right to activate/deactivate it:

switch = Switch(active=True)

To attach a callback that listens to the activation state:

def callback(instance, value):
    print('the switch', instance, 'is', value)

switch = Switch()

By default, the representation of the widget is static. The minimum size required is 83x32 pixels (defined by the background image). The image is centered within the widget.

The entire widget is active, not just the part with graphics. As long as you swipe over the widget’s bounding box, it will work.


If you want to control the state with a single touch instead of a swipe, use the ToggleButton instead.

Kv Example:

        text: 'power up'
        id: switch
        text: 'woooooooooooh' if switch.active else ''
class kivy.uix.switch.Switch(**kwargs)[source]

Bases: kivy.uix.widget.Widget

Switch class. See module documentation for more information.


Indicate whether the switch is active or inactive.

active is a BooleanProperty and defaults to False.


(internal) Contains the normalized position of the movable element inside the switch, in the 0-1 range.

active_norm_pos is a NumericProperty and defaults to 0.


Receive a touch down event.

touch: MotionEvent class

Touch received. The touch is in parent coordinates. See relativelayout for a discussion on coordinate systems.


bool If True, the dispatching of the touch event will stop. If False, the event will continue to be dispatched to the rest of the widget tree.


Receive a touch move event. The touch is in parent coordinates.

See on_touch_down() for more information.


Receive a touch up event. The touch is in parent coordinates.

See on_touch_down() for more information.


(internal) Contains the touch that currently interacts with the switch.

touch_control is an ObjectProperty and defaults to None.


(internal) Contains the distance between the initial position of the touch and the current position to determine if the swipe is from the left or right.

touch_distance is a NumericProperty and defaults to 0.