Dropdown

The Dropdown component allows users to select one or multiple options from a dropdown menu.

Basic usage

import gradio as gr

def greet(name):
    return f"Hello {name}!"

gr.Interface(
    fn=greet,
    inputs=gr.Dropdown(["Alice", "Bob", "Charlie"]),
    outputs=gr.Textbox()
).launch()

Constructor

Sequence[str | int | float | tuple] | None

default:"None"

List of options. Can be simple values or tuples of (label, value)

default:"None"

Default selected value(s). If None with single select, first choice is selected

Literal['value', 'index']

default:"'value'"

Return type:

"value" - Returns selected value(s)
"index" - Returns selected index/indices

bool | None

default:"None"

If True, multiple selections allowed

bool

default:"False"

If True, users can enter custom values

int | None

default:"None"

Maximum number of selections (multiselect only)

bool

default:"True"

Whether users can type to filter options

str | None

default:"None"

Label displayed above component

bool | None

default:"None"

Whether selections can be made

Events

change - Triggered when selection changes
input - Triggered on input
select - Triggered when option is selected
focus - Triggered when component gains focus
blur - Triggered when component loses focus
key_up - Triggered on key release

Examples

With labels and values

import gradio as gr

gr.Dropdown(
    choices=[
        ("Small (256x256)", "small"),
        ("Medium (512x512)", "medium"),
        ("Large (1024x1024)", "large")
    ],
    value="medium",
    label="Image size"
)

Multiselect

import gradio as gr

gr.Dropdown(
    choices=["Python", "JavaScript", "Java", "C++"],
    multiselect=True,
    value=["Python"],
    label="Select languages"
)

Custom values allowed

import gradio as gr

gr.Dropdown(
    choices=["Red", "Blue", "Green"],
    allow_custom_value=True,
    label="Choose or enter a color"
)

Overview

Input Components

Output Components

Layout Components

Control Components

Special Components

Basic usage

Constructor

Events

Examples

With labels and values

Multiselect

Custom values allowed

​Basic usage

​Constructor

​Events

​Examples

​With labels and values

​Multiselect

​Custom values allowed

Basic usage

Constructor

Events

Examples

With labels and values

Multiselect

Custom values allowed