Flow Nodes

All available nodes for building data pipelines in the flow editor

The Flow Editor lets you build chart queries visually by connecting nodes in a pipeline. Drag nodes onto the canvas, configure them, and wire them together — data flows top to bottom from a Data Source through transformations to the Output.

Getting started

  1. Add a Data Source node to pick which adapter and field to read from
  2. Connect transformation nodes like Filter, Group By, or Aggregate to shape the data
  3. End with an Output node to produce the final chart result

Each node has handles on its top and/or bottom edge. Connect the bottom handle of one node to the top handle of the next to build the pipeline. The colored badge on each node tells you what category it belongs to — sources, filters, aggregates, groupings, transforms, time operations, and outputs each have their own color.

Nodes

Data Source

The entry point of every pipeline. Selects which dataset to read from and which field to pull out of it.

  • Adapter — the data provider or dataset (e.g. Events, Sessions). Determines which fields are available below.

  • Field — the specific metric or property to read from the selected adapter.

  • Dedupe — when checked, counts only the latest row per identity (where the data source supports it). Useful for unique-visitor style queries.

Data Source
Adapter
Events
Field
page_view
Dedupe

Filter

Drops rows that do not match a condition. Pick a field, an operator, and a comparison value; only matching rows continue down the pipeline.

  • Field — which upstream field to compare.

  • Operator — how to compare. Available: equals, not equals, contains, matches regex, does not match regex, greater than, less than, greater or equal, less or equal.

  • Value — what to compare against. Becomes a true/false dropdown when filtering a boolean field.

  • Map target — only shown for map fields. Choose whether to filter on the map's keys or its values.

Filter
Field
browser
Operator
equals
Value
Chrome

Aggregate

Reduces multiple rows into one computed value per group. Typically placed after a Group By or Time Group node.

  • Function — how values inside each group are combined:

    • count — number of rows in the group

    • sum — add numeric values

    • avg — average of numeric values

    • min — smallest numeric value

    • max — largest numeric value

    • distinct — count unique values

Aggregate
Function
count

Group By

Groups rows by one or more categorical fields. Usually paired with an Aggregate node to compute per-group metrics (e.g. page views grouped by browser).

  • Fields — the grouping dimensions. Rows that share the same values across these fields are put in the same group. Add as many as you need.

  • Multi-field mode — only shown when more than one field is selected.

    • combined — joins field values into a single composite key (e.g. Chrome / Germany as one group).

    • flat — keeps each field as its own dimension; the chart can break down by either axis.

Group By
Fields
browsercountry
Multi-field mode
combined

Time Group

Groups rows into time-based buckets — the foundation of every time-series chart.

  • Bucket size — interval each row is rolled into: Auto, Minute, Hour, Day, Week, Month. Auto picks a sensible size based on the chart's time range.

  • Missing buckets — what to do with time periods that have no data:

    • Zero — insert a zero value so the line stays continuous.

    • None — leave the gap empty; the series breaks.

Time Group
Bucket size
Hour
Missing buckets
Zero

Text Transform

Rewrites string values before they're grouped, filtered, or displayed. Handy for normalizing inconsistent text (e.g. casing) or extracting derived labels.

  • Operation — which transformation to apply:

    • lowercase / uppercase / title case — change casing

    • trim — strip leading and trailing whitespace

    • append — add a fixed string to the end of each value

    • replace text — find an exact string and replace it

    • replace regex — match a regular expression and substitute (use \1, \2, … for capture groups)

    • length — replace each value with its character count

  • Text to append — only for append. The string added to every value.

  • Find / Pattern and Replace with — only for replace text and replace regex. Leave the replacement empty to delete matches.

Transform
Operation
lowercase

Formula

Computes a derived numeric value from a custom expression. Each input connection to the Formula node is assigned a letter (A, B, C, …) in the order it was connected; use those letters as variables.

  • Expression — the formula to evaluate, e.g. A + B, A / B * 100, (A + B) / C.

  • Output name — name of the resulting field. This is what downstream nodes (and your chart legend) will reference.

  • Precision — number of decimal places to round the result to. Leave empty to keep full precision.

Formula
Expression
(A + B) / C
Output name
ratio
Precision
2

Limit

Caps the number of rows that flow through. Most useful after a Group By to keep only the top N groups in a chart.

  • Max rows — the maximum number of rows to keep.

  • Group rows over limit as Other — instead of dropping the rows beyond the limit, fold them into a single Other bucket so totals still match.

Limit
Max rows
10
Group rows over limit as Other

Max Age

Restricts the pipeline to events from within a rolling window relative to now. Combine with Min Age to look at an arbitrary "X to Y ago" slice.

  • Look back at most — the size of the window. Pick a number and a unit: ms, seconds, minutes, hours, days.

Max Age
Look back at most
24
h

Min Age

Drops events that are too recent. Useful for excluding the "live" tail of data that hasn't fully settled yet, or for comparing past periods.

  • Exclude newer than — events within this window before the current time are removed. Same units as Max Age.

Min Age
Exclude newer than
1
h

Output

The final node of every pipeline — this is what produces the chart result. See Output & Multi-Series for how multiple Output nodes combine into tabs, multi-line charts, or stacked bars.

  • Output name (or Tab name on list charts) — label shown in the chart legend or as the tab header.

  • Icon set — only on list charts. Optional icons shown next to each row.

  • Nest by — only on list and pie charts. Splits each row into a nested hierarchy, either by another data field or by a custom delimiter.

  • Delimiter — only when nesting by a custom pattern. The character or string used to split values (e.g. / to split a URL path).

Output
Output name
page_views

Final query result for this chart

On this page