# Manage Wallboard Widgets

The Wallboard is built from individual widgets, and you control which statistics appear and how they are arranged. This lets you keep the metrics that matter most front and center. This page covers how to add a widget, change its size, pin it in place, remove it, attach a note, and return everything to the default layout.

## Where changes are applied

Every task on this page begins the same way: choose a scope in the top-left corner of the Wallboard, then switch the board into edit mode.

1. In the top-left corner of the Wallboard, select **All** or pick an individual queue.

   ![Scope selector in the top-left of the Wallboard for choosing All or a single queue](/images/pbx/wallboard-select-desired-queue.png)

   :::note
   Your scope choice determines where the edits take effect:
   - **All** applies your widget changes to the current combined view only.
   - A **specific queue** applies your changes to that queue's individual view.
   :::

2. In the top-right corner of the Wallboard, click **Edit**.

   ![The Edit control in the top-right corner of the Wallboard](/images/pbx/edit-a-widget.png)

Once you are in edit mode, follow the steps for the task you want below, and click **Save** when you finish.

## Add a widget

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Click **Add Widget**.
3. From the **Type** drop-down list, choose the statistic you want the widget to show.
4. In the **Note** field, type a short description that suits your needs.
5. Click **Save**.

## Resize a widget

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Point to the lower-right corner of the widget.
3. Hold the widget and drag the border frame up, down, left, or right until the widget is the size you want.

   ![A Wallboard widget being resized by dragging its lower-right corner](/images/pbx/resize-a-widget.png)

4. Click **Save**.

## Move and pin a widget

Pin a widget to hold it in a fixed position so it stays put as you adjust the rest of the layout.

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Drag the widget to the position you want.
3. Click the lock icon ![Lock icon on a widget](/images/pbx/widget-unlock.png) on that widget.

   ![A widget being pinned to a fixed spot on the Wallboard](/images/pbx/lock-a-widget.png)

4. Click **Save**.

## Delete a widget

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Click the delete icon ![Delete icon on a widget](/images/pbx/widget-delete.png) on the widget you want to remove.

   ![Removing a widget from the Wallboard](/images/pbx/delete-a-widget.png)

   :::note
   Deleting a widget only removes it from this Wallboard view. It does not change the queue or the underlying statistics. You can bring the widget back later with **Add Widget**, or restore the whole default layout with **Reset**.
   :::

3. Click **Save**.

## Add a note to a widget

Add a short caption along the bottom of a widget to give context to the statistic it displays.

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Click the settings icon ![Settings icon on a widget](/images/pbx/widget-setting.png) on the widget.

   ![Opening the settings for a widget to add a note](/images/pbx/set-a-widget.png)

3. In the **Note** field, type a short description that suits your needs.
4. Click **Save**.

## Reset all widgets

Discard your customizations and return the widgets to their default layout.

:::caution
Resetting cannot be undone. It discards the custom position, note, and size of every widget in the scope you selected, and you will have to rebuild the layout by hand if you still want it. Only reset when you are sure you want to start over.
:::

1. Enter edit mode as described in [Where changes are applied](#where-changes-are-applied).
2. Click **Reset**, then click **Save**.

   The custom position, note, and size of every widget revert to the default settings.

   ![The Reset control that restores widgets to their default layout](/images/pbx/reset-widgets.png)