---
title: "Add widgets to a mobile dashboard"
slug: "add-widgets-to-a-mobile-dashboard"
updated: 2026-06-02T13:37:19Z
published: 2026-06-02T13:37:19Z
---

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

# Add widgets to a mobile dashboard

To build a mobile dashboard, you need to be an app admin and you need to build the dashboard using the desktop app. To build a dashboard, add widgets (reports, charts, tables, etc.) to the dashboard grid. Learn more about [creating dashboards](/v1/docs/using-dashboards) and adding widgets.

## Add report widgets to a mobile dashboard

You can add all report types to a mobile dashboard and put them on one screen for quick access. You can add these report widgets:

- Tables
- Charts
- Kanban
- Summary
- Timeline
- Map
- Calendar

## Add a button widget

Add a button widget to give your users a way to move between workflows in the mobile dashboard. You can add a button widget as a way for your users to submit forms, open a web page, etc.

## Add a rich text widget

The height of a rich text widget on a mobile dashboard depends on the widget's height in the desktop's dashboard grid. When creating a rich text widget, consider the cell's pixel height to make sure there's enough room for the text to display in mobile.

### Map dashboard grid cells to mobile

One grid cell on desktop is equal to 20% of maximum widget height on mobile.

| \| **Desktop grid cell** \| **Widget height on mobile** \| \| --- \| --- \| \| 1 grid cell \| 20% of maximum widget height \| \| 2 grid cells \| 40% of maximum widget height \| \| 3 grid cells \| 60% of maximum widget height \| \| 4 grid cells \| 80% of maximum widget height \| \| 5 grid cells \| Maximum height of widget \| |
| --- |
| **Desktop grid cell** | **Widget height on mobile** |
| 1 grid cell | 20% of maximum widget height |
| 2 grid cells | 40% of maximum widget height |
| 3 grid cells | 60% of maximum widget height |
| 4 grid cells | 80% of maximum widget height |
| 5 grid cells | Maximum height of widget |

#### Example layout from desktop to mobile

This example shows how the desktop grid translates to the mobile dashboard for rich text widgets.

![Example showing how a desktop dashboard grid with rich text widgets translates to the mobile dashboard layout](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/17185445312404.png)

#### Maximum widget height on mobile

The maximum height of a rich text widget on mobile is 5 grid cells on the desktop's dashboard grid. If you create a rich text widget that's longer than 5 grid cells on the desktop grid, it gets mapped to the maximum height on the mobile dashboard.

![Example showing the maximum height of a rich text widget on mobile, mapped from the desktop grid](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/17185450006932.png)

## Add a search widget

Search widgets let users search for a range of information. When searching, results appear in the mobile table report on a new screen.

## Add a web page widget

You can preview an embedded web page directly on the dashboard in the mobile app. You can activate the widget to interact with the web page or open it in a mobile browser (tap ![Open](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/16283006255892.png) in the upper right corner of the widget).

## Open widgets in the mobile app

When scrolling through a mobile dashboard, widgets (reports, charts, and tables) are view only. You need to tap the widget to activate it first and then you can open it.

To open the report tap ![Open](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/16283006255892.png) in the upper right corner of the active widget.

| ![Mobile dashboard with a widget in focused view, ready to be opened](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/16242239262484.png) | ![Animated demonstration of opening a report from an activated mobile dashboard widget](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/16186143583124.png) |
| --- | --- |

1. Tap the widget to activate it. The widget opens in focused view. Now you can open it.
2. Tap ![Open](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/16283006255892.png) to open the report.

### View data points on a chart

Use a long-press to view a data point label on a chart. Tap a data point to open the record.