Configure a flow visualization

Flow visualizations help you understand the journey stemming from or leading up to a specific conversion event on your website or your app. It traces a path through your dimensions (and dimension items) or metrics.

Flow visualizations let you configure the start or end of the path you are interested in, or analyze all paths that flow through a dimension or dimension item.

new Flow UI

Create a flow visualization configure

  1. Add a blank panel to your project and click the visualizations icon in the left rail.


    Add a visualization in any of the ways described in the “Add visualizations to a panel” section in Visualizations overview.

  2. Anchor your Flow visualization using one of the following options:

    • Starts with (metrics, dimensions, or items), or
    • Contains (dimensions, or items), or
    • Ends with (metrics, dimensions, or items)

    Each of these categories is shown onscreen as a “drop zone.” You can populate the drop zone in 3 ways:

    • Use the drop-down menu to select metrics or dimensions.
    • Drag dimensions or metrics from the left rail.
    • Begin typing the name of a dimension or metric, then select it when it appears in the drop-down list.
    note important
    Calculated metrics cannot be used in the Starts with or Ends with fields.
  3. If you choose a metric, you also need to provide a Pathing Dimension to use to use as your path leading to or going from your selected component, as shown here. The default is Page.

    pathing dimension

  4. (Optional) Select Show advanced settings to configure any of the following options:

    advanced settings

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Setting Description
    Wrap labels Normally, the labels on the Flow elements are truncated to save screen real estate, but you can make the entire label visible by checking this box. Default = unchecked.
    Include repeat instances

    Flow visualizations are based on instances of a dimension. This setting gives you the option to include or exclude repeated instances, e.g. Page reloads. However, repeats cannot be removed from Flow visualizations that include multi-valued dimensions, such as listVars, listProps, s.product, merchandising eVars, etc.

    This option is disabled by default.

    Limit to first/last occurrence Limit paths to those that start/end with the first/last occurrence of a dimension/item/metric. See the section below, Example scenario for ‘limit to first/last occurrence’, for a more detailed explanation.
    Number of columns The number of columns you want in your Flow diagram. You can specify a maximum of 5 columns.
    Items expanded per column The number of items you want in each column. You can specify a maximum of 10 items expanded per column.
    Flow container
    • Visit
    • Visitor

    Lets you switch between Visit and Visitor to analyze visitor pathing. These settings help you understand visitor engagement at the visitor level (across visits), or constrain the analysis to a single visit.

    note important
    The combination of Number of columns and Items expanded per column determine the number of underlying requests required to create the flow visualization. The higher those numbers, the longer it takes to render a visualization.
  5. Select Build.

Example: Suppose that you want to trace the path that users took both to and from the most popular pages on your site.
To do this, you would
  1. Begin creating a flow visualization as described above.
  2. Drag the Page dimension into the Contains field, then select Build.
  3. The Flow visualization builds with the most-viewed page visible in the focus node in the center of the visualization. You also see the top pages leading into that page (to the left of the focus node) as well as the top pages leading out of that focus page (to the right of the focus node).
  4. Analyze data in the flow, as described in View and change the Flow output.

View and change the Flow output output

flow output

A summary of the Flow configuration appears at the top of the diagram. The thickness of a path in the diagram is proportional to its activity, with paths with more activity appearing thicker than those with less activity.

To drill down further into the data, you have several options:

  • The flow diagram is interactive. Mouse over the diagram to change the details that are shown.

  • When you select on a node in the diagram, the details for that node appear. Select on the node again to collapse it.


  • You can filter a column to display only certain results, such as including and excluding, specifying criteria, and so forth.

  • Select the plus sign (+) on the left to expand a column.

  • Use the right-click options explained below to further customize the output.

  • Select the pencil icon next to the configuration summary to further edit the flow or rebuild it with different options.

  • You can also export and further analyze your Flow diagram as part of a project’s .CSV file by going to Project > Download CSV.


Above each column, a filter appears when you hover over it. By selecting the filter, you get the same filter dialog that exists in the Freeform table today. This filter works the same as it does in the Freeform table.

  • Use advanced settings to include or exclude certain criteria with our list of operators.
  • Once you have filtered an item from the list, that specific column will reflect the filtering. (The filter either reduces it to only show the item allowed in the filter, or it removes all items except for the one item you want in the filter.
  • All downstream and upstream columns should persist, as long as there is data flowing into the remaining nodes.
  • Once applied, the filter icon appears in blue above the column it is filtering.
  • To remove a filter, select the filter icon to open the filter menu. Remove any filters applied and then select Save. The flow should return to its previous, unfiltered state.

Right-click options right-click

Start over
Returns you to the Freeform diagram builder, where you can build a new Flow diagram.
Create segment for this path
Create a segment. This takes you into the Segment Builder, where you can configure the new segment.
Break the node down by available Dimensions, Metrics, or Time.
Create a trended diagram for the node.
Show next column / Show previous column
Reveals the next (right) or previous (left) column of the visualization.
Hide column
Hides the selected column from the visualization.
Expand entire column
Expand a column to show all nodes. By default, only the top five nodes display.

Example scenario for ‘limit to first/last occurrence’

When using this option, keep in mind that:

  • Limit to first/last occurrence counts only the first/last occurrence in the series. All other occurrences of the Starts with or Ends with criteria are discarded.
  • If used with a Starts with flow, only the first occurrence that matches the start criteria is included.
  • If used with an Ends with flow, only the last occurrence that matches the end criteria will be included.
  • The series used differs based on the container. If using the Visit container, the series of hits will be the session. If using the Visitor container, the series of hits will be all the hits for a given user in the provided date range.
  • The Limit to first/last occurrence option can be configured in the advanced settings when using a Metric or Dimension Item in the “Starts with” or “Ends with” fields.

Example series of hits:

Home > Products > Add to cart > Products > Add to Cart > Billing > Order Confirmation

Consider a flow analysis using the following settings:

  • Start with Add to cart (Dimension Item)
  • Page pathing dimension
  • Visit container

If Limit to first/last occurrence is disabled, then this single series of hits counts 2 occurrences of “Add to Cart”.
Expected Flow Output:
“Add to Cart” (2) —> “Products” (1)
-> “Billing” (1)

However, if Limit to first/last occurrence is enabled, only the first occurrence of “Add to cart” is included in the analysis.
Expected Flow Output:
“Add to Cart” (1) —> “Products” (1)

Consider the same series of hits but using the following settings:

  • Ends with Add to cart (Dimension Item)
  • Page pathing dimension
  • Visit container

If Limit to first/last occurrence is disabled, then this single series of hits would count 2 occurrences of “Add to Cart”.
Expected Flow Output:
“Products” (2) <— “Add to cart” (2)

However, if Limit to first/last occurrence is enabled, only the last occurrence of Add to cart would be included in the analysis.
Expected Flow Output:
“Products” (1) <— “Add to cart” (1)