Building Custom Dashboards

Why build a dashboard

The Overview is a great default, but every team watches a different set of numbers. A custom dashboard lets you assemble exactly the widgets you want — a marketing dashboard, a support dashboard, an executive summary — and save it for reuse. Each dashboard is a special kind of report view made of widgets.

What a widget is

Every widget on a dashboard is defined by a few fields:

• id — a stable identifier for the widget.
• type — the widget kind (for example a metric tile).
• title — the label shown on the widget.
• metric_key — the metric or event the widget displays (for example platform_total_events or form_submission).
• group_by — an optional property to break the widget out by.
• range — the time window, such as 30d.

A dashboard can hold up to 24 widgets, which is plenty for a focused view.

Step-by-step: create a dashboard

1. Open the Dashboards area of StretchAnalytics.
2. Choose New dashboard and give it a clear title (for example "Marketing — Weekly").
3. Add a description so teammates know its purpose.
4. Add your first widget: give it a title, choose a metric_key, optionally set a group_by, and pick a range.
5. Repeat to add more widgets (up to 24).
6. Save. The dashboard is created and appears in your dashboards list.

Step-by-step: edit an existing dashboard

1. Open the dashboard from your list.
2. Choose Edit.
3. Add, remove, or retitle widgets, or change a widget's metric, group-by, or range.
4. Save. Your changes update the existing dashboard in place.

Step-by-step: pause or archive

1. Open the dashboard.
2. Set its status to paused to keep it but hide it from active use, or archived to remove it from lists.
3. Save. Archived dashboards no longer appear; paused ones remain listed.

Example

A head of growth builds a "Growth — Weekly" dashboard with four widgets: a Page views tile (range 7d), a CTA clicks tile grouped by page_path, a Form submissions tile (range 7d), and a Total events tile (range 30d) for context. Every Monday the team opens one dashboard instead of running four Explore queries, and the numbers are always framed the same way.

Tips

• Give each dashboard a single audience and cadence ("Support — Daily") rather than cramming everything into one.
• Keep widget titles action-oriented so the dashboard reads like a status report.
• Use consistent ranges across a dashboard so widgets are comparable at a glance.
• Pair a dashboard with a scheduled email export so the same view lands in inboxes automatically.
• Archive dashboards you no longer use instead of deleting them, so you can revive them later.

Troubleshooting

A widget shows zero. Confirm its metric_key matches an event or metric that has activity for your organization, and that the range covers a period with data.

I can't add more widgets. Dashboards are capped at 24 widgets. Split a crowded dashboard into two focused ones.

My edits didn't stick. Make sure you saved after editing. Editing updates the existing dashboard; creating without an id makes a new one.