> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/dashboards/adding-widgets.md). # Adding Widgets A dashboard comes alive when you add widgets — the individual display panels that show what your sensors are doing right now. But the same temperature sensor in the bedroom and the same temperature sensor watching a fridge are not the same thing. One widget shows comfort. The other shows whether your groceries are safe. The value is identical in type; the meaning is entirely different. This is what widgets are designed for. You choose what each one shows, set the ranges and colors that match the context, and give it a name that makes sense for where it lives. Two widgets can read from the same sensor and look completely different because you've configured them for different purposes. ## How to add a widget to a dashboard Before you can add widgets, you need a dashboard. If you haven't created one yet, see [Building a Dashboard](/dashboards/building-a-dashboard.md). **Opening edit mode:** Open the dashboard, tap the **actions menu** (three dots) in the top right, and select **Edit dashboard**. The dashboard enters edit mode — you'll see a **Cancel** button and a **Save** button appear in the header, replacing the Live Data indicator. **If the dashboard is empty:** An empty dashboard shows **"You have no widgets here"** with an **Add widget** button in the center. Tap it to open the widget picker. **If the dashboard already has widgets:** In edit mode, a **plus (+) button** appears — use it to add more widgets. You can also tap the **three-dot menu** on any existing widget to edit, move, resize, or delete it. **Saving your changes:** After configuring a widget, tap **Save** in the widget settings to add it to the dashboard. When you're done arranging, tap **Save** in the dashboard header to exit edit mode and keep your layout. ## Choose the right widget | Widget | Use it when | What it shows | | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [Last Data](/dashboards/adding-widgets/last-data-widget.md) | You need to know what something is doing right now | The latest value received from one or more sensors | | [Chart](/dashboards/adding-widgets/chart-widget.md) | You need to see how a value changed over time | A historical graph plus the live current reading | | [Image](/dashboards/adding-widgets/image-widget.md) | You want to see sensor data pinned onto an image — a floor plan, a room photo, a diagram | Your own uploaded image with live numeric readings pinned to their locations | | [Map](/dashboards/adding-widgets/map-widget.md) | You want to see where a GPS-reporting device is right now | Current position on a real outdoor interactive map, plus one sensor reading on the marker | | [iFrame](/dashboards/adding-widgets/iframe-widget.md) | You want a web page you check often — weather, traffic, a calendar — right on your dashboard | A live web page from a supported service, embedded in the tile next to your sensors | | [Digital Building Twin](/dashboards/adding-widgets/digital-building-twin.md) | You want a 3D model of your home with sensors mapped to real rooms and objects | A 3D editor that turns your home into a live picture, colored by what your sensors say | ## What comes next * [Last Data Widget](/dashboards/adding-widgets/last-data-widget.md) — Latest sensor values, gauges, and per-sensor conditions * [Chart Widget](/dashboards/adding-widgets/chart-widget.md) — Time-series graphs with live current reading and threshold bands * [Image Widget](/dashboards/adding-widgets/image-widget.md) — Any image with draggable live-data pins * [Map Widget](/dashboards/adding-widgets/map-widget.md) — GPS tracker location with route history * [iFrame Widget](/dashboards/adding-widgets/iframe-widget.md) — Pin a live web page — weather, traffic, calendar — next to your sensors * [Digital Building Twin](/dashboards/adding-widgets/digital-building-twin.md) — A 3D model of your home that lights up with live sensor readings * [Conditions](/dashboards/adding-widgets/conditions.md) — Color rules that turn readings into meaning * [Organizing Your Views](/dashboards/organizing-your-views.md) — Group dashboards into folders --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chirpwireless.io/dashboards/adding-widgets.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.