Skip to main content
The Number component creates a numeric input field for entering and displaying numbers.

​
Basic usage

import gradio as gr

def double(num):
    return num * 2

gr.Interface(fn=double, inputs=gr.Number(), outputs=gr.Number()).launch()

​
Constructor

​
value
float | Callable | None
default:"None"
Default value. If None, component shows placeholder or 0
​
label
str | None
default:"None"
Label displayed above the component
​
placeholder
str | None
default:"None"
Placeholder hint text
​
precision
int | None
default:"None"
Precision for rounding. If 0, converts to int. If None, no rounding
​
minimum
float | None
default:"None"
Minimum allowed value. Raises error if user provides smaller value
​
maximum
float | None
default:"None"
Maximum allowed value. Raises error if user provides larger value
​
step
float
default:"1"
Increment step for the number
​
interactive
bool | None
default:"None"
Whether the number field is editable

​
Events

  • change - Triggered when value changes
  • input - Triggered on every keystroke
  • submit - Triggered when Enter is pressed
  • focus - Triggered when component gains focus
  • blur - Triggered when component loses focus

​
Examples

​
With validation

import gradio as gr

gr.Number(
    label="Age",
    minimum=0,
    maximum=120,
    precision=0,
    value=25
)

​
With precision

import gradio as gr

gr.Number(
    label="Price",
    precision=2,  # 2 decimal places
    value=19.99
)