Skip to main content
A widget is an individual block on a page. A data widget connects to a data source and displays a metric or breakdown; other widgets add headings, text, images, buttons, or embeds.
1

Open the report or dashboard

From the client’s Projects tab, open the project.
2

Select the page

For a report, click the page you want to add the widget to. (A dashboard is a single view.)
3

Open the Add Content tab

In the editor sidebar, open the Add Content tab.
4

Drag a content type onto the canvas

Drag Data Query, Heading, Textbox, Image, Button, or Embed onto the grid where you want it. See Content types.
5

Configure it

For a Data Query, pick the data source, metric, and optional dimension, then set the data. See Configure a widget.
A dashboard is capped at 50 widgets. Reports paginate instead, so they have no widget cap.

​
API

POST /v1/widgets batch-upserts widgets. Oviond saves the whole project atomically and also auto-saves as you work. For a data widget, configure it with plain identifiers — pass metric and dimension ids (from GET /v1/data/{datasource_id}/metrics):
  • metrics / dimensions are arrays of metric/dimension ids.
  • chart is one of table, score, area, line, bar, column, pie, donut, funnel, map.
  • filters (optional) is an array of { field, operator, value }; see Querying data for operators.
Over MCP, the equivalent is widgets_add_data with the same datasource_id, metrics, dimensions, and chart.