Skip to main content
The Slider component creates a slider for selecting numeric values within a range.

Basic usage

import gradio as gr

def adjust_brightness(value):
    return f"Brightness: {value}%"

gr.Interface(
    fn=adjust_brightness,
    inputs=gr.Slider(0, 100),
    outputs=gr.Textbox()
).launch()

Constructor

minimum
float
default:"0"
Minimum slider value
maximum
float
default:"100"
Maximum slider value
value
float | Callable | None
default:"None"
Default value for slider
step
float | None
default:"None"
Increment between slider values. If None, auto-calculated
precision
int | None
default:"None"
Precision for rounding. If 0, converts to int
label
str | None
default:"None"
Label displayed above the component
randomize
bool
default:"False"
If True, value is randomly set within range on load
buttons
list[Literal['reset']] | None
default:"None"
Buttons to show. Options: "reset" to reset to default value

Events

  • change - Triggered when value changes
  • input - Triggered while dragging slider
  • release - Triggered when slider is released

Examples

Integer slider

import gradio as gr

gr.Slider(
    minimum=1,
    maximum=10,
    step=1,
    value=5,
    label="Select a number"
)

With custom step

import gradio as gr

gr.Slider(
    minimum=0,
    maximum=1,
    step=0.1,
    value=0.5,
    label="Confidence threshold"
)