Gradio Agents & MCP Hackathon · Virtual, June 2-8 · $10k+ in prizes

Register Now
  1. Blocks Layout
  2. Group

New to Gradio? Start here: Getting Started

See the Release History

To install Gradio from main, run the following command:

pip install https://gradio-builds.s3.amazonaws.com/23b789d7e5dbf62c19c1d49d3584489716de0788/gradio-5.32.1-py3-none-any.whl

*Note: Setting share=True in launch() will not work.

Group

gradio.Group(···)

Description

Group is a layout element within Blocks which groups together children so that they do not have any padding or margin between them.

Example Usage

with gr.Group():
    gr.Textbox(label="First")
    gr.Textbox(label="Last")

Initialization

Parameters
🔗
visible: bool
default = True

If False, group will be hidden.

🔗
elem_id: str | None
default = None

An optional string that is assigned as the id of this component in the HTML DOM. Can be used for targeting CSS styles.

🔗
elem_classes: list[str] | str | None
default = None

An optional string or list of strings that are assigned as the class of this component in the HTML DOM. Can be used for targeting CSS styles.

🔗
render: bool
default = True

If False, this layout will not be rendered in the Blocks context. Should be used if the intention is to assign event listeners now but render the component later.

🔗
key: int | str | tuple[int | str, ...] | None
default = None

in a gr.render, Components with the same key across re-renders are treated as the same component, not a new component. Properties set in 'preserved_by_key' are not reset across a re-render.

🔗
preserved_by_key: list[str] | str | None
default = None

A list of parameters from this component's constructor. Inside a gr.render() function, if a component is re-rendered with the same key, these (and only these) parameters will be preserved in the UI (if they have been changed by the user or an event listener) instead of re-rendered based on the values provided during constructor.