---
title: "Dashboard Widget"
slug: "dashboard-widget"
updated: 2026-01-21T14:59:33Z
published: 2026-01-21T14:59:33Z
canonical: "docs.sightmachine.com/dashboard-widget"
---

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

# Dashboard Widget

Deployed App Pages can be added as widgets to dashboards.

### Enable dashboard widget

In the Page Settings, enable save to dashboard. Optionally, set the refresh interval for the widget.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image-1769007551398.png)

This will enable Save To Dashboard and Add New Widget for this App Page.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(250).png)

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(251).png)

### Widget Layout Customization with `widget_layout_props`

By default, every panel returned on the page will be displayed in the dashboard widget. The page developer can change this default behavior by adding `widget_layout_props` to the Page Logic response. The `widget_layout_props` has the same format as `grid_layout_props` but will only apply to the dashboard widget. For example, the page below has two panels by default, but with `widget_layout_props`, the widget will only show the `plotly-chart`.

If only one panels exist in the widget, the panel will auto-resize when the widget changes size. Otherwise, the layout in `widget_layout_props` will be used.

```python
grid_layout_props = {
    "layout":[
    {
        "w": 8,
        "h": 12,
        "x": 0,
        "y": 0,
        "i": "plotly-chart",
        "static": "true"
    },
    {
        "w": 4,
        "h": 12,
        "x": 8,
        "y": 0,
        "i": "markdown-panel",
        "static": "true"
    }
]}

widget_layout_props = {
      "layout":[
    {
        "w": 8,
        "h": 12,
        "x": 0,
        "y": 0,
        "i": "plotly-chart",
        "static": "true"
    }
]}

# === Structure the output response ===

response = {
    "grid_layout_props": grid_layout_props,
    "widget_layout_props": widget_layout_props,
    "panels": [chart_panel, markdown_panel]
}
```