> ## Documentation Index
> Fetch the complete documentation index at: https://openmetadata-docs-release-watchers.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore the Lineage View | Official Documentation

> Explore lineage diagrams interactively to understand how data flows between sources, transformations, and dashboards.

# Explore the Lineage View

OpenMetadata's Lineage view shows end-to-end data flow at both the table and column level, for Database, Dashboard, and Pipeline assets.

Search for a data asset and expand the graph to see its lineage:

* Each node expands to show its upstream and downstream edges.
* Each edge carries details such as the SQL query, pipeline information, and column-level lineage.

## Source, Target, and Edges

In the example below:

* The table on the left is the parent, or **Source** node.
* The table on the right is the **Target** node — identifiable by the arrow pointing into it.
* The arrow connecting them is the **Edge**.

Click an edge to see its details: the Source, Target, Description, and SQL Query. For a view, the SQL query shows how the target was generated from the source.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/edge.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=3a28f8a5b86ecca0f032966b51e4dfb0" alt="Edge Information: Source and Target" width="3002" height="1408" data-path="public/images/how-to-guides/lineage/edge.png" />

<Tip>
  Metadata ingestion also brings in view lineage, if the database has views (data assets of the type View).
</Tip>

## Lineage Config

Use the gear icon's **Lineage Config** to change how many Upstream and Downstream Nodes this view displays, as well as the Nodes per layer. None of these fields have a fixed maximum. This only affects your current view: it resets to the platform default the next time you open a lineage graph.

To configure the lineage nodes, follow the steps below:

1. Click the **Setting** icon.

   <img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/lineage-setting.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=a673f1a157e2a0b2049c05565231f554" alt="Lineage Setting" width="2996" height="1664" data-path="public/images/how-to-guides/lineage/lineage-setting.png" />

2. Set the following:

   * **Upstream Depth**: Number of upstream hops shown by default when opening a lineage graph, to identify parent-level sources.
   * **Downstream Depth**: Number of downstream hops shown by default when opening a lineage graph, to identify child-level targets.
   * **Nodes Per Layer**: Maximum number of nodes shown per layer. If a layer has more nodes than this, the rest are paginated instead of all being rendered at once.

   <img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/nodes.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=e9d461d4f6d86df5b0b9bbb98965b6f4" alt="Lineage Config" width="2978" height="1316" data-path="public/images/how-to-guides/lineage/nodes.png" />

To change the default for every session, see [Lineage](/v1.13.x/how-to-guides/admin-guide/preferences/lineage).

## Impact Analysis View

The Lineage page has two tabs at the top: **Lineage** (the graph you've seen so far) and **Impact Analysis** — a table that lists the same upstream and downstream assets as rows instead of nodes on a graph, which is easier to scan, search, and sort when an asset has a large number of dependencies.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/impact-analysis.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=29be520692ec74d19829659dfb5c5b96" alt="Impact Analysis table view" width="2840" height="1390" data-path="public/images/how-to-guides/lineage/impact-analysis.png" />

* **Upstream / Downstream**: Switch direction. Each option shows a count of how many assets lie in that direction.
* **Impact On**: Choose whether the table lists **Asset Level** impact (one row per table, pipeline, dashboard, and so on) or **Column Level** impact (one row per source-to-target column mapping).
* **Customize**: Choose which columns to show. Name (or Source/Impacted Column, in Column Level mode) always stays visible. Every other column can be toggled off.
* Search narrows the rows by asset name (Asset Level) or column name (Column Level).

**Asset Level** columns: Name, Node Depth (number of hops from the asset you're viewing), Description, Domains, Owners, Tier, Tags, and Glossary Terms.

**Column Level** columns: Source, Source Column, Impacted (the downstream or upstream asset), Impacted Column, plus the same Node Depth, Description, Domains, Owners, Tier, Tags, and Glossary Terms columns.

## Data Asset Details

Click a data asset to view its details:

* **Source, Name, Description, Owner** (team/user), **Tier**, and **Usage** information.
* Additional details based on the **type of data asset** (Table, Topic, Dashboard, Pipeline, ML Model, Container) — for example, a table's type, number of queries, and columns.
* **Data quality and profiler metrics**, including tests passed, aborted, and failed.
* **Tags** associated with the data asset.
* **Schema** details: column names, column types, and column descriptions.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/lineage2.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=64a9a07880253e9f2bdec5a75ebfcc6d" alt="Quick Glance at the Data Asset from Lineage View" width="2990" height="1660" data-path="public/images/how-to-guides/lineage/lineage2.png" />

## Column-Level Lineage

Click a table to expand its list of columns and see column-level lineage.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/lineage1.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=c9652662b3a9e24cf64feee4fdc94a0c" alt="Column-Level Data Lineage in OpenMetadata" width="2850" height="1564" data-path="public/images/how-to-guides/lineage/lineage1.png" />

## Pipeline and Dashboard Lineage

For **Pipelines**:

* Lineage first comes from the metadata ingested from the databases.
* Setting up pipeline ingestion with a database service name links the pipeline to the database tables it reads from and writes to.
* If a pipeline creates the lineage, that shows up in the edge information too.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/pipeline.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=217be19f5567085ee68d8ac3a272c071" alt="Database and Pipeline Lineage" width="2700" height="852" data-path="public/images/how-to-guides/lineage/pipeline.png" />

**Dashboards** work the same way:

* Lineage first comes from the metadata ingested from the databases.
* Dashboard ingestion then adds the data models and charts, linking them back to the database tables they're built on.

## Lineage Layers

Lineage view supports multiple exploration layers that provide deeper insights into the structure, flow, and quality of data across your ecosystem. These layers help you visualize lineage not just at the dataset level, but also across services, domains, and business-critical data products.

### Column Layer

The **Column layer** enables detailed exploration of column-level lineage, letting you trace the flow and transformation of specific fields (for example, `customer_id`, `first_name`) across tables and pipelines. This granularity helps you understand data dependencies at the attribute level.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/column-layer.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=e5c7e70735c46cca3387e7ad2cf29903" alt="Column Layer in Lineage" width="2822" height="1462" data-path="public/images/how-to-guides/lineage/column-layer.png" />

### Observability Layer

The **Observability layer** integrates data quality insights directly into lineage by displaying test outcomes such as passes, failures, and pending checks. This helps you identify potential issues and assess the trustworthiness of data as it moves through the pipeline.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/observability-layer.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=dcb8436803b9ad436abb4e6c15601764" alt="Observability Layer in Lineage" width="2834" height="1476" data-path="public/images/how-to-guides/lineage/observability-layer.png" />

### Service Layer

The **Service layer** visualizes how data flows across different platforms and services like Hive, Redshift, Power BI, and Tableau. It connects ingestion, transformation, and consumption points, offering a system-level view of the end-to-end data journey.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/service-layer.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=dfa6585f28f367e4af456cc80e3d56f3" alt="Service Layer in Lineage" width="2830" height="1484" data-path="public/images/how-to-guides/lineage/service-layer.png" />

### Domain Layer

The **Domain layer** organizes datasets and assets into business-relevant categories such as "Ecommerce" or "Customer Data." This classification provides contextual clarity and supports governance by aligning technical assets with business functions.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/domain-layer.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=506a1127b4c39fa3d1a13a83f3b82c16" alt="Domain Layer in Lineage" width="2838" height="1474" data-path="public/images/how-to-guides/lineage/domain-layer.png" />

### Data Product Layer

The **Data Product layer** highlights curated outputs like *Customer Registry* or *Superstore*, representing the final, value-delivering datasets within a domain. It enables you to track the lineage of trusted, consumption-ready data products across the organization.

<img src="https://mintcdn.com/openmetadata-docs-release-watchers/O_IoB3-oeuYz9UMk/public/images/how-to-guides/lineage/data-product-layer.png?fit=max&auto=format&n=O_IoB3-oeuYz9UMk&q=85&s=cb2579d474aa383976b5b254efead4f1" alt="Data Product Layer in Lineage" width="1615" height="569" data-path="public/images/how-to-guides/lineage/data-product-layer.png" />

<Card title="How Column-Level Lineage Works" href="/v1.13.x/how-to-guides/data-lineage/column">
  Explore and edit the rich column-level lineage.
</Card>
