Number

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

float | Callable | None

default:"None"

Default value. If None, component shows placeholder or 0

str | None

default:"None"

Label displayed above the component

str | None

default:"None"

Placeholder hint text

int | None

default:"None"

Precision for rounding. If 0, converts to int. If None, no rounding

float | None

default:"None"

Minimum allowed value. Raises error if user provides smaller value

float | None

default:"None"

Maximum allowed value. Raises error if user provides larger value

float

default:"1"

Increment step for the number

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
)

Overview

Input Components

Output Components

Layout Components

Control Components

Special Components

Basic usage

Constructor

Events

Examples

With validation

With precision

​Basic usage

​Constructor

​Events

​Examples

​With validation

​With precision

Basic usage

Constructor

Events

Examples

With validation

With precision