Skip to Content
DocumentationFeaturesURL Parameters

URL Parameters

Colibri supports URL parameters that enable shareable views. You can control models, depth, highlighted column and more.

Currently the url parameters work well navigating based on a pre-constructed url. While you navigate the UI, some parameters (e.g. model, column, focusMode) will update, however it does not capture your full session state. For example if you hide/show extra models, this is not reflected yet in the url.

Some Common Use Cases

1. Share a Specific Model View

?model=fct_orders&children=2&parents=2

2. Highlight a Column’s Lineage (with end stops)

?model=dim_customers&column=customer_id&focus=true&children=3&parents=2

3. Trace Full Column Lineage

See every model connected to a column via column-level relationships:

?model=fct_orders&column=order_total&children=all&parents=all

This shows only the models that have direct column-to-column connections to order_total.

4. View Complete Dependencies

See all upstream or downstream models for impact analysis:

Parameters Reference

model

Type: string
Required: No (defaults to first available model)

Specifies which model to display as the root of the lineage visualization.

?model=dim_stores

When you click on any model node in the graph, the URL automatically updates to reflect your selection, making it easy to share exactly what you’re viewing.

column

Type: string
Required: No

Highlights a specific column within the selected model and its lineage path.

?model=dim_stores&column=store_key

Behavior varies based on depth parameters:

  • Without children=all and parents=all:
    The column is highlighted within the model-level lineage graph. The children and parents parameters control which models are loaded, and the column highlighting shows the path through those models.

  • With both children=all AND parents=all:
    Fetches the complete column-level lineage. Only models that have direct column-to-column connections are shown, creating a focused view of where this specific column flows.

focus

Type: boolean
Default: false
Values: true, false, 1, 0

Enables focus mode, which shows only highlighted columns in expanded models, hiding unrelated columns for a cleaner view.

?model=dim_stores&column=store_key&focus=true

This is particularly useful when tracing a specific column through a complex lineage with many models.

children

Type: number | "all"
Default: 1

Controls how many levels of downstream (child) models to load and display.

# Show 2 levels of downstream models
?model=dim_stores&children=2
 
# Show all downstream models
?model=fact_sales&children=all

Examples:

  • children=0: Show only the selected model (no downstream)
  • children=1: Show direct downstream dependencies
  • children=3: Show 3 levels downstream
  • children=all: Show complete downstream lineage

parents

Type: number | "all"
Default: 1

Controls how many levels of upstream (parent) models to load and display.

# Show 3 levels of upstream models
?model=dim_stores&parents=3
 
# Show all upstream models
?model=fact_sales&parents=all

Examples:

  • parents=0: Show only the selected model (no upstream)
  • parents=1: Show direct upstream dependencies
  • parents=n: Show n levels upstream
  • parents=all: Show complete upstream lineage

hideSidebars

Type: boolean
Default: false
Values: true, false, 1, 0

Hides the sidebar panels for a full-screen lineage view, useful for presentations or embedded views.

?model=dim_stores&hideSidebars=true
# All upstream (for understanding sources)
?model=fct_orders&parents=all&children=0
 
# All downstream (for impact analysis)
?model=stg_raw_orders&children=all&parents=0
Last updated on
CLIContribute