Core concepts

A quick tour of the building blocks of widgets.pro — dashboards, widgets, data sources, and more.

A quick tour of the things you'll see referenced across these docs. One paragraph each — follow the links for the full guide.

Dashboard

A dashboard is a page of widgets arranged on a responsive grid. It's the main thing you'll create and share. You can have as many as your plan allows, customise each with a background and theme, and share them publicly, with a password, or with specific people. See Dashboards.

Widget

A widget is one tile on a dashboard — a chart, a number, a table, an RSS feed, a clock, a weather forecast. You add widgets from the picker, configure them in a side panel, and drag them around the grid. See Widgets.

Data source

A data source is a connection to data outside widgets.pro — a website's API, a Google Sheet, a database, an RSS feed, or a CSV file you upload. Once connected, you can bind it to any widget. See Data sources.

Integration

An integration is a one-click connector to a popular service — GitHub, Linear, Plausible, Stripe. Sign in once, and the integration gives you ready-made data sources (e.g. "Open PRs in repo X") without writing any API calls. See Integrations.

Template

A template is a pre-built dashboard you can clone in one click and then customise. Templates cover popular use cases — SaaS metrics, web analytics, devops monitoring, personal home dashboard, and more. See Templates.

Theme

A theme controls the colours, fonts, and feel of a dashboard. Pick light, dark, or system — or apply your workspace's Brand Kit for custom colours and typography across every dashboard at once. See Themes.

Brand Kit

The Brand Kit is your workspace's branding — logo, colours, fonts, chart palette — set once and applied to every dashboard. See Brand Kit.

Organization (workspace)

An organization (or workspace) is a shared space for you and your teammates. Dashboards, data sources, and integrations belong to the workspace. You can belong to multiple workspaces — switch between them from the top-left org picker. See Organizations & teams.

Marketplace (Explore)

The marketplace is where you browse and install community-published widgets and dashboards. Open the Explore tab in the app — search by category, see what's popular, and install with one click.

TV device

A TV device is a paired display showing one of your dashboards — a lobby screen, a kiosk, an office wallboard. You pair a device once with a 6-digit code and manage it remotely. See TV & digital signage.

AI Designer

Describe a dashboard in plain English and let the AI build it for you. The AI Designer picks the right widgets, hooks them to your connected data sources, and arranges the layout. See AI Designer.


Advanced: entity IDs

You'll mostly never need to see these, but every object in widgets.pro has a unique ID with a short prefix. You might spot them in URLs, exports, or API responses:

PrefixWhat it is
dsh_Dashboard
wdg_Widget
ds_Data source
tv_TV device
tvp_TV playlist
intg_Integration
shr_Public share link
inv_Invitation link
uf_Uploaded file

If you're building automations or integrating with the API, the full list lives in the API reference.