Widgets are the visual building blocks of a report.
They are created on the layout, then configured in the Edit Panel where data and appearance can be adjusted.
Widget Creation Copy Link
Drag and drop is the main mechanism for Widget creation - this can be done by dragging data or Widgets into the page. Alternatively, clicking on the Widget icons in the Compose Panel will also create a Widget on the page.
When a Widget is dragged, it snaps to the Layout Grid and a preview shows the proposed placement. If the Widget would exceed the layout, placement is clamped to the nearest valid position and size. Where possible, the Widget is resized to fit the available space.
Once the Widget is created, it can be resized from its edges or corners (depending on the Widget). Resizing also snaps to the grid. Some Widgets enforce a minimum size. For example, the Table Widget has a minimum height of 220px (equivalent to 4 rows, including the header).
The example below shows an empty page in Edit Mode. Widgets can be created by dragging a Widget from the Edit Panel or dragging a field from the Data Panel onto the canvas.
Widget Types Copy Link
The following are the supported Widget types in AG Studio and their input requirements.
| Widget type | Description | Input requirements |
|---|---|---|
| Table | Shows detailed data in a simple table. | Any Fields can be added. |
| Chart | Show patterns such as trends, comparisons, and distributions. | Input requirements vary by chart type and usually include at least one Category field and one Value field. |
| KPI | Shows a headline number. | Requires a single Value field or measure. |
| Static Content | Adds narrative or supporting content such as text and images. | Does not require data inputs. |
| Filter | Add on-canvas filter controls. | Requires a field that can be used to filter the report, such as a list of values or a date field. |
Once a Widget is on the layout, configure its data inputs and appearance in the Edit Panel. See Building Widgets for the Setup and Format tabs.
Widget Toolbar Copy Link
When a Widget is focused, a toolbar is displayed with actions for working with the Widget. Widget focus is indicated by a default blue border around the Widget.
The available actions depend on the current Mode and the Widget type. For example, some actions are only available in Edit mode, and different Widget types may show different menus.
| Name | Icon | Mode | Description |
|---|---|---|---|
| CSV |  | Both | Exports the Widget data as a CSV file. |
| Download |  | Both | Downloads the chart as an image. |
| Duplicate |  | Edit | Creates a copy of the Widget. |
| Delete |  | Edit | Removes the Widget from the layout. |
Table and Chart Widgets show a CSV button. Chart Widgets also show a Download button for exporting the chart as an image. The Table Widget does not have a Download button.
CSV Export Copy Link
The CSV button exports the Widget data as a CSV file, using the Widget title as the filename. Values are formatted the same way as in the Widget.
Empty State Copy Link
If a Widget runs successfully but returns no rows, AG Studio shows a consistent empty state. This could be due to empty underlying Fields or active Filters not returning any results. The empty state uses a single message ("No data to display") and is centred within the Widget.
The example below shows the same bar chart with a page-level filter applied that returns no matching data. The Filters Panel is open to show the active filter condition.