Widgets

Widgets are self-contained modules that visualize specific data, added to the pages of a Site — a count of non-working servers, a chart of data distribution, a list of objects matching a filter.

Managing widgets

Widgets use a StarQL query to find and narrow the data they show.

• Create — open a page's Configure menu (top right) to enter edit mode, press + Add widget, choose a type, and configure it. Changes persist automatically.
• Place — drag a widget to reposition it; moving one doesn't displace others.
• Resize — drag a corner (some widgets have a minimum grid size).
• Configure — in edit mode, click a widget's cogwheel icon.
• Refresh — widgets refresh automatically on page entry; a manual refresh button (hover to see the last refresh time) is available for data-dependent widgets in both edit and read mode.
• Clone — in edit mode, click a widget's clone icon; the copy opens its configuration immediately.
• Delete — in edit mode, click a widget's delete icon.
• Download as image — hover a Chart or Two-dimensional report widget and click its download icon to save it as a PNG or JPG, ready to paste into a slide or report. The image shows the widget as it appears on screen, with a line underneath noting that it was exported from Starhive, when, and by whom. The file is named after the widget's title. In edit mode the icon sits in the widget's toolbar alongside refresh, clone, configure, and delete.

Every widget has appearance settings (text, background color/image, border color/style/width/ radius) that take priority over the page's own settings.

Available widgets

Widget	What it shows
Object Count	The count of objects in scope.
Numbers	The sum or average of a number attribute across objects in scope, chosen with Aggregation type (Sum by default). Takes an Integer, Decimal, Calculated, Rating, Depreciation, or Completeness attribute; a Completeness attribute can only be averaged.
Chart	A pie/bar/bubble chart of an attribute's distribution (excludes Media and Date Range).
Object List	A configurable list of objects; opens object details, with a further StarQL input for the viewer to filter. Can be limited to objects created by the current user.
Board View	Objects grouped into columns by a Workflow attribute, same idea as the Board view.
Recently Updated	Recently updated objects across the whole workspace, not scoped to one type.
Related to Me	Objects where the current user appears in any User-type attribute.
Starhive Introduction	Welcome content and links to docs/examples.
Rich Text	Free-form formatted text.
Object Form	A form for creating objects, with default values, hidden fields, read-only fields, and conditional attributes (show/hide fields based on other field values via IF/THEN rules, combinable with AND).
Depreciation Value Graph	Book value over time for a Depreciation attribute, over a chosen date range.
Depreciation Value Sum	Aggregated (accumulated or future) book value across objects with a Depreciation attribute.
Nova Chat	An embedded chat with a Nova agent.
Object Percentage	Two StarQL filters on the same type — a base count and a total count — shown as base / total, as a percentage (e.g. "% of tickets that are closed").
Web Link Button	A labeled button that opens a fixed URL, in the same tab, a new tab, or a new window.
Matrix	Objects compared on a square grid by two numbers, with configurable axes and cell colors, to prioritize work, evaluate options, assess risks, or plan portfolios. See Matrix.
Time series	How a number changes over time, such as a price, revenue, or hours per day, week, or month, drawn as a line, area, bars, or steps. See Time series.
Two-dimensional report	Objects counted by two attributes at once, a Primary dimension and a Secondary dimension, shown as a Table, Heatmap, or Bubble matrix. Values can be the number of objects, % of row, or % of column, with optional row and column totals.
Timeline	Objects placed on a timeline by their dates: a Date Range attribute, or a start and an end Date or Date Time attribute. Objects can be grouped by an attribute, or by sub type, and week numbers can be shown.

Every widget besides Recently Updated, Related to Me, Starhive Introduction, Rich Text, and Web Link Button takes a Type and an optional StarQL filter as configuration, alongside its own type-specific fields.

Rolling out

App widgets are rolling out gradually and may not be available in every workspace yet. Where they are, each installed app that provides a widget appears in the widget picker under its own name, under Content & Forms.

Matrix

Rolling out

The Matrix widget is rolling out gradually and may not be available in every workspace yet.

The Matrix compares a type's objects on a square grid by two numbers: one along the bottom (the horizontal axis) and one up the side (the vertical axis). Each cell is colored by what that combination means, and a circle in it shows how many objects it holds. Use it wherever objects are scored on two scales, for example:

• Risks by likelihood and impact, as in a risk register or a DORA or ISO 27001 assessment.
• Work by value and effort, or by urgency and importance, to decide what to do first.
• Options or portfolios by any two scores, such as strategic fit and cost.

Setting it up

In the widget picker, the Matrix is under Charts. On the General tab:

• Type — the type whose objects to place.
• Horizontal axis — the number placed along the bottom, such as likelihood or effort. An Integer, Decimal, Calculated, or Rating attribute.
• Vertical axis — the number placed up the side, such as impact or value. The same kinds of attribute, and a different attribute from the horizontal axis.
• Size — how many levels each axis has, from 2 × 2 to 10 × 10. New widgets start at 5 × 5.
• A StarQL filter, optional as on every widget.

On the Zones tab:

• Colour zones — a cell's score is its horizontal level times its vertical level, and each zone colors the cells up to its score. A zone has a color, an optional Name, and an Up to score; the last zone covers everything above the others (From … and above). Use Add zone to add one, and the delete icon to remove one. New widgets start with three zones, Low (green), Medium (orange) and High (red): at 5 × 5 those cover the scores 1–4, 5–12 and 13 and up, and at 10 × 10 they cover 1–16, 17–48 and 49 and up.
• Horizontal axis level names and Vertical axis level names — optional names for the levels, lowest first, such as Rare, Unlikely, Possible, Likely, Almost certain, or Low, Medium, High. A level without a name shows its number.

When you change Size, zones that are still the defaults move to the new size's defaults and keep their names; zones you changed yourself stay as they are. Level names are kept where they fit.

How objects are placed

Each object goes on the level its value rounds to: on either axis, 2.9 and 2.5 are on level 3, and 2.4 is on level 2. The axes should therefore use a scale from 1 to the matrix size, such as likelihood or effort from 1 to 5 on a 5 × 5 matrix.

An object with no value on either axis, or a value that rounds below 1 or above the matrix size, can't be placed. The widget counts these objects under the grid as N objects are outside the matrix. A value stored as a fraction (0.3) or a percentage (30) won't fit the grid; use a 1-to-size scale for both attributes instead.

Reading the matrix

• Circles — the number in a circle is how many objects share that cell. The circle grows with its count compared with the fullest cell. From 1,000 a count is shortened, such as 1.2K.
• Hover a cell — any cell, empty or not, says where it is, its score and its zone, for example Likelihood Possible × Impact 3 and Score 6 · High (5+), with the number of objects when it holds any. Hovering a cell with a single object shows a preview of that object.
• Click a circle — a cell with one object opens that object; a cell with several opens a list of them over the page.
• The legend — under the grid, the legend says what the score is (Score = Likelihood × Impact) and lists each zone with its scores and how many objects are in it. Click a zone to list all its objects, across every cell it covers.
• Outside the matrix — click N objects are outside the matrix to list the objects that couldn't be placed.

External site users see the matrix, its counts and its tooltips, but can't open the objects behind them.

Nova can add a Matrix when it builds a site. On a risk register it picks the number attributes named like a likelihood and an impact for the two axes.

Time series

The Time series widget shows how a number changes over time: a price, revenue, hours logged, or simply how many objects were created each month. Each object is placed in a period by one of its dates, and the widget shows one value per period.

Setting it up

In the widget picker, Time series is under Charts. On the General tab:

• Type — the type whose objects to plot.
• Date — the date that places each object in a period. A Date or Date Time attribute, or when the object was created or last updated.
• Show — what each period's value is:
  • Latest value — the value of the object with the latest date in the period, such as the most recent price. New widgets start with this.
  • Sum, Average, Minimum, Maximum — of the value across the period's objects.
  • Number of objects — how many objects fall in the period. This needs no Value.
• Value — the number to show for each period. An Integer, Decimal, Calculated, Rating, Depreciation, or Completeness attribute.
• Period — Day, Week, Month, Quarter, or Year. New widgets start with Month.
• Style — Line, Area, Bars, or Steps. New widgets start with Line.
• A StarQL filter, optional as on every widget.

Objects without a value for the Date attribute aren't placed in any period.

Reading the chart

• Periods — the chart runs from the first period with objects to the last, in date order. Periods follow UTC calendar days, and weeks start on Monday.
• Periods with no new values — a Sum or Number of objects is 0 in a period with no objects. Latest value, Average, Minimum, and Maximum keep the value of the period before when a period has no objects, or none of its objects has a value, so a price stays at last month's price until a new one is recorded.
• Values — the vertical axis and the values use the value attribute's number format, such as a currency or a percentage.
• Hover a period — the tooltip names the period and its value, and either how many objects it covers or, for a kept value, No new values; same as the period before.
• Click a period — opens a list of the objects in it. External site users see the chart and its tooltips, but can't open the objects behind it.

The chart can show at most 1,000 periods, from the first to the last. A widget that would need more, such as ten years of days, shows Too many periods to show; choose a longer period, such as Month instead of Day.

When a Chart widget is set up with a date attribute, its settings point to Time series: a Chart counts objects per value, while a Time series shows a number over time.