> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ospribrain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizing Your Dashboard

> Add, remove, rearrange, and resize widgets on your Dashboard.

## Adding Widgets

<Steps>
  <Step title="Click Add Widget">
    In the top-right corner of the Dashboard, click the **Add widget** button.
  </Step>

  <Step title="Choose a widget">
    A dropdown appears showing widgets that aren't currently on your Dashboard. Click one to add it.
  </Step>

  <Step title="Widget appears">
    The new widget is added to the bottom of your grid layout.
  </Step>
</Steps>

<Note>
  **Alex's screenshot note:** Take a screenshot showing the "Add widget" dropdown open with available widget options listed.
</Note>

## Removing Widgets

1. Hover over any widget
2. A small **X** button appears in the top-right corner
3. Click it to remove the widget from your Dashboard

The widget is removed from your layout but can be re-added anytime using **Add widget**.

## Rearranging Widgets

Widgets can be moved by dragging:

1. Grab the widget by its **title bar** (the drag handle area)
2. Drag it to a new position on the grid
3. Other widgets automatically rearrange to make room
4. Release to drop

<Tip>
  The grid has 2 columns on large screens and 1 column on small screens. Widgets snap to the grid automatically.
</Tip>

## Resizing Widgets

1. Hover over the **bottom-right corner** of any widget
2. A resize handle appears
3. Drag to resize the widget (height adjusts to content)

## Resetting Your Layout

If you want to start fresh:

1. Click the **Reset** button in the top-right corner (next to Add widget)
2. All widgets are restored to the default layout

<Warning>
  Resetting replaces your entire custom layout with the default. This cannot be undone.
</Warning>

## Default Layout

The default Dashboard layout is:

| Position         | Widget                    |
| ---------------- | ------------------------- |
| Top (full width) | This Week (Meeting Stats) |
| Row 2, Left      | Upcoming Meetings         |
| Row 2, Right     | To-Dos                    |
| Row 3, Left      | Recent Recordings         |
| Row 3, Right     | Active Deals              |
| Row 4, Left      | Quick Links               |
| Row 4, Right     | Vault Activity            |

## Layout Persistence

Your layout is automatically saved to the server whenever you make a change (with a 1-second debounce to avoid excessive saves). It persists across:

* Page refreshes
* Browser sessions
* Different devices (tied to your account)

<Note>
  **Alex's screenshot note:** Take a screenshot of a customized Dashboard with widgets rearranged in a non-default order, showing the drag handle on one widget.
</Note>