Visualization options reference — every control in every builder
A flat catalog of every control in the Module 8 visualization builders, one tab per builder. Pick the visualization you're configuring. The lessons that walk you in the door are Your first chart, Chart data shaping, and Aggregate grid and pivot grid; this page is the lookup you come back to. The specialized visualizations each get their own tab too: the KPI card and the calendar are here now, with maps, Financials, and more added as they land.
By the end of this lesson
- Find any visualization control by the builder and accordion it lives in
- Know which options appear when — by chart type, and by whether a grid field is grouped
Background
The eight chart types that share one builder — line, bar, column, stacked column, pie, area, range bar, and scatter. The builder organizes its controls into accordions with two scopes: per-series controls inside Add New that apply to one value series at a time, and chart-wide controls in the accordions below the series list.
Some controls only appear for certain chart types; those are flagged inline, and the applicability matrix at the end of this tab lists every type-specific control in one place.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Value Field (per series)
The number this series plots. Only number and currency fields are eligible — text fields can't be a value series. Range Bar is the exception: it asks for two value fields (the start and end of each span).
-
Values Options (per series)
-
Color Options (per series)
Select Bar Color (the label tracks the chart type — bar, line, area) sets this series' color. Pick a swatch or enter a hex value; the default is
#25A0DA. Set per series, so a multi-series chart can give each series its own color. -
Symbol Options (per series — scatter only)
Only on a Scatter Plot. Select Symbol sets the marker shape for the series:
circle,square,cross,triangleUp, ortriangleDown. -
Chart Options (chart-wide)
-
Display Options (chart-wide, type-specific)
This list grows and shrinks with the chart type. The type-specific rows are noted.
-
Hover Options (chart-wide)
Target Document points the chart at another report to open on interaction. Use Select Target Document to pick it, Clear Target to remove it. This is distinct from a Field Builder drill-down on the underlying grid — covered in Drill-downs.
-
Applicability — which options appear for which chart type
If you're stuck
"Where did that option go?" — for charts the answer is usually the chart type.
Display as Spline isn't there
Spline only appears for Line and Area charts. On a column or bar there's nothing to curve.
Series in rows is missing
You're on a Range Bar, which is columns-only. Every other chart type offers both orientations under Select Series Type.
The argument dropdown won't show my number field
By design — it lists text fields until you check Allow Numeric Argument Fields in Chart Options. See Chart data shaping.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Background
The plain data grid — the default output before you pick a visualization — has its own Config menu in the preview toolbar. Four controls, enough for a simple grouped or totaled list. Step-by-step walkthroughs are in the linked help articles.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Default data grid — Config menu
The plain data grid — the default output before you choose a visualization — has its own Config menu in the preview toolbar. Four controls, enough for a simple grouped or totaled list. One limit to keep in mind: the totals and subtotals here are presentation-layer — they don't recalculate when a viewer sorts or filters. When you need totals that stay correct, use the Aggregate Grid below. Step-by-step: Add Totals and Hierarchy.
If you're stuck
The one thing to watch on the default grid.
My totals look right, then go wrong when I sort or filter
Default-grid totals and subtotals are presentation-layer — an extra row that doesn't move with the data. For totals that recalculate on filter and follow the rows on export, rebuild them in the Aggregate Grid tab.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Background
A specialized visualization with its own builder (Visualizations → Aggregate Grid). Each report field is a card; the three-dots menu configures it. Totals here are attached — they recalculate on filter and follow the rows on export. The aggregate grid does not support drill-down.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Aggregate Grid
A specialized visualization with its own builder (open Visualizations → Aggregate Grid). Each report field is a card with a checkbox (ticked = included); click the three-dots menu to configure it. Totals here are attached — they recalculate on filter and follow the rows on export, unlike the default grid. The Aggregate Grid does not support drill-down. Step-by-step: How to create a new Aggregate Grid report.
Per-field action menu (three dots)
Settings accordion
Heading Colors (apply only when a column is grouped)
Group Top Level Color (default
#E9E9E9) and Group Sub Level Color (default#F9F9F9) shade the group heading rows.Data Row Conditional Highlighting
Shade rows by a rule — e.g. color a status, or compare two numeric columns. Add more than one rule; the trash icon deletes one. Step-by-step: color conditional row highlighting.
If you're stuck
Most aggregate-grid surprises come down to whether a field is grouped.
SubTotals (and In Group Footer, Align By Column) aren't in the field menu
Those appear in the Aggregate Grid only once the field is grouped. Set Group By → Grouped first, then reopen the field's menu.
Heading Colors does nothing
Heading Colors only take effect when at least one column is grouped — they shade the group heading rows. No grouping, nothing to shade.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Background
A specialized cross-tab visualization with its own builder (Visualizations → Pivot Grid). You arrange fields into Rows, Columns, Data, and Filter areas and the preview rebuilds in real time. The pivot grid does not support drill-down.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Pivot Grid
A specialized cross-tab visualization with its own builder (open Visualizations → Pivot Grid). You arrange fields into areas and the preview rebuilds in real time. Good for showing the important facts rather than every detail. The Pivot Grid does not support drill-down. Step-by-step: How to configure a Pivot Grid report.
Field areas (field chooser)
Right-click a field
Sidebar checkboxes
Show Field Chooser reopens the drag-and-drop chooser. Saving the pivot stores its current state — which dimensions are expanded and which filters are set; users open in that state and can keep expanding and filtering live, with values recalculating.
If you're stuck
The one that catches everyone first.
My pivot value shows a count, not a sum
A Pivot Grid data field defaults to Count. Right-click the value, set Summary Type → Sum (or Avg/Min/Max), and set the Format Type while you're there.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Background
The KPI card builder (Visualizations → KPI). Its accordions appear in a fixed order down the sidebar; several are gated by your Value Source and by whether your date carries a year, so a control that’s missing usually means your data can’t support it yet (see the pitfalls at the end of this tab). The walkthrough is The KPI card; this is the control-by-control lookup.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Title, Display Type, Value Column
KPI Title — the heading above the number; leave blank to show the value alone; type
@to insert a report value. Select Display Type — Big Number and Trend (one value, optional comparison, goal, and small chart). Select Value Column — the column the card reads its number from; must be typed as a number for Sum/Average (text can only Count). -
Value Source (and its period fields)
Pick a period-based source and four more fields appear:
-
Number Format, Value Color
Number Format — None / Fixed point / Percent / Large number (
1.2M) / Currency, with decimals and currency symbol. Display only; never changes the arithmetic. Value Color — the color of the large value (text values are colored too). -
Comparison Options
Compare to — the recipe (time-based source only)
You’re only offered recipes your data can calculate. If a recipe reaches past the end of your data, the comparison simply doesn’t render.
-
Trend Options
Trend — None / Line-area / Bars, a small chart of the value over time. Needs a period-based source and a readable date. Bar Color (Bars only), Show points on the line, Highlight high & low points. Dense data is grouped automatically so the shape stays readable.
-
Status and Thresholds
Tick Show a status label based on value to add a colored word beside the change chip.
If the reference can’t be worked out — no goal, a goal of zero, a missing prior period — no status word is shown rather than a meaningless color.
-
Goal Options
Heading — the word before the target (defaults to
Goal; tryTargetorBudget), with prefix/suffix labels. Direction — Higher is good / Higher is bad / None; colors the arrow (the arrow always points at where the value sits relative to the target). A goal of zero is a real goal. -
Caption and Subtitle
In Caption, type
@for a token the card resolves at run time. Subtitle is a fixed line beneath. Tokens that can’t resolve render as nothing. -
Interactivity
Drill-down — set a Target Report and the card becomes clickable, opening filtered to the rows behind the number (for a period card, the exact date range of the period clicked). Map period to target date field names the field in the target to filter; the target must share the same underlying date field. Viewer Controls — let dashboard readers switch the period grain (with Periods offered) or the comparison basis, without editing the card; nothing is saved. Neither appears for year-less period labels.
If you're stuck
“Where did that option go?” — for the KPI card it’s almost always the Value Source or a missing year.
No Group by, or no “same period last year”
Your period labels have no year, so the card can’t roll up or compare across years. Add the year: March → Mar-2026.
No Trend, no Comparison recipes
The Value Source isn’t period-based, or the report has no readable date. Switch the source to Latest period, or fix the date column.
Status word never appears
The reference can’t be resolved — no goal, a goal of zero, or no prior period. Check Compare to under Status and Thresholds.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Background
The Calendar builder (Visualizations → Calendar). Its controls split by Display Type: Numeric (colored values) shows value + formatting + color legend; Text (labels) shows a label + how to resolve a busy day. Switching modes hides the controls that don’t apply. The walkthrough is The calendar visualization; this is the lookup. One thing that governs everything: build the Date Field as a timezone-aware type (DTZ or DOZ), or days shift by the viewer’s time zone.
Can't find a control, or one's behaving unexpectedly? Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
Do it
-
Display Type, Date Field
Display Type — Numeric (colored values) or Text (labels); everything below changes to match. Date Field — the column that places each row on a day; only readable dates appear. Build it as DTZ or DOZ (Add Formula → change the type) so browser time zones don’t push rows onto the day before — on this report and any drill-down target.
-
Numeric mode — value and busy days
Current Value Field — the number a day is colored by; a text field falls back to counting rows.
Comparison Value Field (optional) — a second number to measure the day against, with Comparison to Zero deciding what shows when it’s zero: Infinite / Absolute / NoData / Current.
-
Text mode — label and how to pick one
Label Field — the column whose value is written on the day.
Rank By — the measure totaled per label, shown only for Top label by a measure.
-
Number Format (numeric mode)
Format Type — None / Fixed Point / Percent / Large Number (
1.2M) / Currency, with Decimal Places and Currency Code where they apply. Display only. -
Color Legend (numeric mode)
Show Legend turns it on; Legend Position places it (Top/Bottom, Left/Center/Right); No Data Color / Text colors days with no rows. Legend Mode is Static (discrete bands) or Gradient (a continuous scale — available once a comparison exists, and can read as a percent).
A day matching no band takes the No Data color, so a catch-all band is a good habit.
-
Display Options and roll-ups
Totals and averages are computed from the underlying data, not the rounded number shown on each day. In Text mode, the roll-up reports the period’s most common label.
-
Comparison Type
-
Drilldown Options
Target Report — makes each day clickable, opening the target filtered to that day. Select Date Field — the field in the target to filter (it must contain that same date field, or it’s ignored). Use Criterias — passes the calendar’s own filters through too. The target’s date field should also be DTZ/DOZ, or the drilled day won’t line up.
If you're stuck
The ones that catch everyone — the first before you configure anything else.
Days are shifted one day earlier
The Date Field is a plain type (DAT/DPO); the browser time zone offsets it. Rebuild it as DTZ or DOZ — on this report and any drill-down target.
The value only offers Count
The Current Value Field is text. Override its data type to a number for Sum/Average, or use Count of records.
Every day is the No Data color
No band matches those values. Check the coverage strip for gaps and add a catch-all band.
None of these match my situation
Email [email protected] with the visualization type and the control you're after. Real human, same business day reply.
