Skip to content
Adoptiv

Embedded Widgets

A widget that belongs to a place in the product rather than to a board. Name a slot at the call site, author the thing once, and everybody who opens that screen sees it computed against their own records.

A figure that lives on the billing screen

1 definition, every workspace
Slot
billing.wallet_topups2 to 64 lowercase · dots or underscores between segments · unique platform-wide
Three workspaces open the same screen
How it stays current
  • Defaulta poll every 60 seconds
  • Marked liveevery 5 seconds
  • Tab in the backgroundpaused entirely
  • Hover refreshskips the cache and reseeds it
What the endpoint asks the definition for
  • calculation
  • modules
  • dateFilter
  • filters
  • groupBy
  • tableColumns
  • rowLimit
  • gaugeTarget
  • cacheTtlSec
  • isRealtime
  • name
  • tooltip
  • iconKey
What it never asks for
  • chartVisual
  • visualConfig
  • themeSetId
  • additionalCalculations
  • pivotConfig
  • crossFilterEmits
  • drillThroughTargetDashboardId
So the tile always draws plain

The default renderer for its shape, in default colours. A series tile plots its first measure alone and a table tile can never become a grid, because the extra measures and the pivot settings are not read either. No click emission, no hop to another board.

Where it renders
a component in the signed-in productiframescript tagthird-party host
Cached against the widget's own window, keyed by workspace and by a version counter every record write bumps · a window of zero disables it
The screen asks for a name and does not know or care which widget carries it. That indirection is the whole contract: the call site is a string, and the operator owns what the string resolves to.
0
widget per slot across the platform
0
characters a slot name may run to
0
seconds between refreshes by default

Product figures from the platform’s own defaults - not customer averages

The mechanism

How it works.

01

The slot is the whole contract

Lowercase letters and digits joined by dots or underscores, two to sixty-four characters, unique platform-wide. The screen asks for a slot by name. Whichever widget carries that name answers, and swapping which widget answers is a rename rather than a code change.

02

Nothing is copied into the workspace

The definition stays on the platform side and is executed against the connection of whoever asked. One authored definition serves every workspace, and none of them holds a copy that can drift from it.

03

Deliberately thin authorisation

Any signed-in member may render any slot. There is no board permission to check, because the definition is the operator's and the records are already fenced by whose session is asking. That is the trade being made and it is worth knowing before a sensitive figure is published to one.

04

How it stays current

A poll every minute, or every five seconds when the definition is marked live, paused entirely while the tab is in the background. A hover button forces a pass that skips the cache and reseeds it.

Where it sits

One moment in every number.

Every number passes through the same seven. Embedded Widgets is the lit one, and everything either side of it is a different page in this category.

  1. 01
    Query

    what is asked, and of what

  2. 02
    Shape

    the measure and the dimension

  3. 03
    Draw

    the visual chosen for that shape

  4. 04
    Arrange

    where it sits on a dashboard

  5. 05
    Filter

    narrowing it after the fact

  6. 06
    Drill

    going from the number to the rows

  7. 07
    Share

    who else gets to see it

The specifics.

8 facts
Slot
Two to sixty-four lowercase characters with dots or underscores between segments
Uniqueness
One definition per slot, across the whole platform
Where it renders
Inside the signed-in product, as a component against a session-scoped endpoint. It is not an iframe, a script tag or anything a third-party site can host
Presentation
The chosen renderer, the palette and the presentation settings travel with the definition, so a slot draws the tile as it was authored
Shape limits
Extra measures and pivot settings travel too, so a series tile plots all of its measures and a table tile can be a grid
Interaction
No click emission and no hop to another board
Caching
The widget's own window, keyed by workspace and by a version counter every record write bumps. A window of zero disables it
Not the same as
Dashboard Sharing, which hands over a whole board to people who already have accounts

More in Reporting & Analytics

12 capabilities

Seven data shapes, twenty-two visuals, shareable without the portal.

Chart Visuals

Columns, funnels, treemaps, radar, scatter, gauges and pivots - offered only where the data shape supports them, so no chart can misread its own data.

Dashboards

Build as many as the floor needs, arrange them on a grid, and give each team the one that answers their question rather than everybody's question.

Cross-Filtering

Click a bar and the rest of the dashboard follows it, so the next question is asked by pointing at the answer instead of rebuilding the filter.

Drill-Through

Wire a chart's clicks to a second dashboard. The value travels on the URL and is read by the board that was named before it paints for the first time.

Pivot Tables

Cross one dimension against another with row, column and grand totals - the shape a finance team asks for when a chart will not settle the argument.

Conditional Formatting

Colour a number by the rule that matters - under target, over threshold, inside a band - so a dashboard reads correctly from across the room.

Reference Lines

Draw the target on the chart itself, so performance is read against the number that was promised rather than against the shape of the bars.

Comparison Periods

Put a window against the one before it, or against the same window a week, month, quarter or year back, on a card as a difference or a chart as a series.

Filter Trees

Seventeen operators in a nested and-or tree, so the report that needs two exceptions and a date range stays one widget instead of becoming three.

Bucketing & Grouping

Group by day through year, by equal-width bands, or by breakpoints you set, each band carrying a sort key so the axis reads in bucket order.

Theme Sets

Six palettes including a print set, pinned per widget, each carrying eight series colours plus the axis, grid, card and tooltip colours drawn around them.

Call Analytics

Total calls, answered rate, average duration and missed calls, split by direction and outcome, over the call records rather than a sampled export.

Reporting & Analytics

See embedded widgets on your own floor.

Thirty minutes, your numbers and your data. We will set embedded widgets up live and you can decide from the thing itself rather than from this page.

14-day trial · no card · migration included