Skip to main content

Product Lineage Tab

The Lineage tab in a product's detail view provides a focused visualization of that product's dependencies.

Accessing Product Lineage​

  1. Open any data product from the catalog
  2. Click the Lineage tab
  3. The graph loads with the current product at center

You can also navigate directly via URL:

/catalog/{product-id}#lineage

Graph Interface​

Layout​

The graph uses a hierarchical column layout where upstream sources (inputs) appear in the left columns, the current product is highlighted in the center, and downstream consumers (outputs) are displayed in the right columns.

Visual Elements​

The graph visually distinguishes elements for clarity. The Current Product Node is highlighted in the center with distinct styling. Linked Product Nodes represent upstream and downstream dependencies. Blue Upstream Edges connect sources, while green Downstream Edges connect consumers.

Node Content​

Each node displays the product's name and a color-coded type icon. Clicking a node navigates directly to that product's detail page.

Depth Controls​

Control how many levels of dependencies are visible using the depth selectors in the graph header. You can independently adjust Upstream Depth to trace sources back 1 to 3+ levels, and Downstream Depth to trace consumers forward. The graph automatically updates as you change these settings.

tip

Start with depth 1 for a clear view, then expand as needed for impact analysis.

Interactive Features​

You can Pan the canvas by clicking and dragging, and Zoom using scroll or on-screen controls. A Fit View button ensures the entire graph is visible, while a Minimap assists with orientation. Nodes can be hovered over to preview information, clicked to navigate, or dragged to reposition them for better visibility.

Connection Panels​

Below the graph, two panels list connections in text form with count badges in the headers.

Upstream and Downstream Panels​

The Upstream Sources Panel lists all products that feed into the current one, revealing their type and depth level. Similarly, the Downstream Consumers Panel lists all products that depend on the current one. Clicking any product in these lists navigates to its detail page.

Managing Connections​

If you have edit permissions, you can curate lineage directly from this tab.

Adding Connections​

To add a source, click Add Upstream in the corresponding panel, search for the product in the modal, and select it to establish the link. Adding a consumer works the same way via the Add Downstream button.

Removing Connections​

To remove a relationship, simply find the connection in the appropriate panel and click the remove icon to delete it.

Bidirectional Updates

When you add or remove a connection, both products are automatically updated. Adding A as upstream of B also adds B as downstream of A.

Empty State​

If no connections exist, the graph displays a helpful empty state with prompts and quick-add buttons to encourage you to build out the lineage.

Troubleshooting​

Common Issues​

If expected nodes are missing, ensure all products are in the same space, active (not archived), and that the lineage changes were saved. If nodes overlap due to layout issues, try dragging them to new positions or adjusting the depth. If changes don't persist, verify your edit permissions and network connectivity.

Best Practices​

Maintenance and Documentation​

Keep lineage current by updating it whenever data pipelines change and removing obsolete connections. For products with complex dependencies, use the description field to explain key relationships, tag products by domain, and coordinate major changes with downstream stakeholders to minimize disruption.