---
title: Widget group
description: Display related widgets as one set.
---

A widget group tells the renderer that its widgets belong together. The group
has no title or layout options. Use a section to give the group a title. The
renderer controls the screen layout.

The group accepts widgets and zones that produce widgets. It does not accept
other blocks.

## API

```ts
widgets.group(widgets: Producer<Widget>[]): WidgetGroupBuilder
```

Pass the complete content when you create the group. The builder has no other
methods.

## Basic group

A group can contain one widget when its relationship to other page content must
remain explicit.

<BacklitExample path="widgets/group/basic" view="overview" />

## Multiple widgets

Pass related widgets in their display order.

<BacklitExample path="widgets/group/multiple_stats" view="overview" />

## Zones in a group

A zone can produce a widget inside a group. The SDK checks that the zone
produces a widget and not another block type.

<BacklitExample path="widgets/group/zones" view="overview" />