# Getting Started with Lineage

Source: https://userguide.qualytics.io/lineage/getting-started/

The lineage graph, manual connections, data catalog integration lineage, and Qualytics-generated lineage are core capabilities. Only [collecting lineage directly from a datastore](https://userguide.qualytics.io/lineage/deep-dive/lineage-sources/#source-collection) requires DC. Viewing imported lineage is a core capability.

Lineage lets you trace how data flows between containers and fields across your datastores, so you can understand where data quality issues start and where they spread. Every container has a **Lineage** tab centered on it, and every datastore has one that shows which datastores it exchanges data with and all of its containers that have lineage.

In this section you will learn how lineage works, how connections are created and managed, and how to navigate the graph. **Members** and **Managers** can add or remove connections when they have **Editor** permission on every associated datastore. **Admins** can edit connections in any datastore.

![The Lineage tab for a table, with its upstream and downstream containers, the enrichment tables Qualytics wrote from it, and two Snowflake assets that are not registered in Qualytics](https://userguide.qualytics.io/assets/lineage/getting-started/getting-started-1.png)

## Deep Dive

- **Introduction**

  What lineage is, why it is worth keeping, and what the rest of this deep dive covers.

  [Introduction](https://userguide.qualytics.io/lineage/deep-dive/introduction/)
- **How It Works**

  The connection model, the two levels of granularity, the rules a connection has to obey, and how to find the containers that have one.

  [How It Works](https://userguide.qualytics.io/lineage/deep-dive/how-lineage-works/)
- **Lineage Sources**

  The five categories a connection can come from, and how each is created, updated, and removed.

  [Lineage Sources](https://userguide.qualytics.io/lineage/deep-dive/lineage-sources/)
- **Reading the Graph**

  Direction, nodes, assets outside Qualytics, where a connection came from, and expanding the graph.

  [Reading the Graph](https://userguide.qualytics.io/lineage/deep-dive/reading-the-graph/)
- **Datastore-level Lineage**

  The datastore map, the lineage between two datastores, and every container of a datastore that has lineage.

  [Datastore-level Lineage](https://userguide.qualytics.io/lineage/deep-dive/datastore-level-lineage/)
- **Field-level Lineage**

  Expanding field lists, field metadata (type, status, anomaly counts), and the focal field workflow.

  [Field-level Lineage](https://userguide.qualytics.io/lineage/deep-dive/field-level-lineage/)
- **Impact Analysis**

  What a container feeds and what feeds it, ranked across a datastore and exportable as CSV.

  [Impact Analysis](https://userguide.qualytics.io/lineage/deep-dive/impact-analysis/)
- **Examples**

  Enrolling a warehouse, a medallion pipeline across datastores, a remediation output, and a hop only a person can record.

  [Examples](https://userguide.qualytics.io/lineage/deep-dive/examples/)
- **Best Practices**

  Which source to lean on, how to run collection, and how to keep a graph you can trust.

  [Best Practices](https://userguide.qualytics.io/lineage/deep-dive/best-practices/)
- **Permissions**

  What each role can do, which team permissions apply, and why a deleted connection can come back.

  [Permissions](https://userguide.qualytics.io/lineage/deep-dive/permissions/)

---

## How-tos

### Connections

- **Add an Upstream Connection**

  Record that another container or field feeds the one you are on, with the field reference for the panel.

  [Add an Upstream Connection](https://userguide.qualytics.io/lineage/how-tos/connections/add-upstream-connection/)
- **Add a Downstream Connection**

  Record that the container you are on feeds another one, with the field reference for the panel.

  [Add a Downstream Connection](https://userguide.qualytics.io/lineage/how-tos/connections/add-downstream-connection/)
- **Delete a Connection**

  Remove a connection, and what that does and does not change.

  [Delete a Connection](https://userguide.qualytics.io/lineage/how-tos/connections/delete-an-edge/)

### Navigate the Graph

- **Expand the Graph**

  Load one more step from a node, or follow a whole side of the graph to its end.

  [Expand the Graph](https://userguide.qualytics.io/lineage/how-tos/graph/expand-the-graph/)
- **Show More Neighbors**

  Draw the next batch of a container's neighbors, or pick the ones you want by name.

  [Show More Neighbors](https://userguide.qualytics.io/lineage/how-tos/graph/show-more-neighbors/)
- **Focus on a Container or Field**

  Dim everything that is not connected to the container or field you picked.

  [Focus on a Container or Field](https://userguide.qualytics.io/lineage/how-tos/graph/focus-on-a-field/)
- **View Anomalies from the Graph**

  Open the Anomalies side panel from a container or field directly on the graph.

  [View Anomalies from the Graph](https://userguide.qualytics.io/lineage/how-tos/graph/view-anomalies/)

### Datastore Lineage and Impact

- **View a Datastore's Lineage**

  Open the datastore map, the lineage between two datastores, or all of a datastore's containers.

  [View a Datastore's Lineage](https://userguide.qualytics.io/lineage/how-tos/datastore/view-datastore-lineage/)
- **Run an Impact Analysis**

  List what a container feeds and what feeds it, or rank a datastore's containers, and export the list.

  [Run an Impact Analysis](https://userguide.qualytics.io/lineage/how-tos/datastore/run-an-impact-analysis/)

---

## Reference

- **Tips & Tricks**

  Every control on the canvas and map toolbars, the More options menu, and how to keep a growing graph readable.

  [Tips & Tricks](https://userguide.qualytics.io/lineage/tips-and-tricks/)
- **Troubleshooting**

  What to check when the tab is missing, a collection finds nothing, or a connection will not stay deleted.

  [Troubleshooting](https://userguide.qualytics.io/lineage/troubleshooting/)
- **API**

  API endpoints and examples for managing lineage connections and querying the graph programmatically.

  [API](https://userguide.qualytics.io/lineage/api/)
- **FAQ**

  Common questions about the lineage graph, datastore lineage, impact analysis, connections, permissions, and the API.

  [FAQ](https://userguide.qualytics.io/lineage/faq/)

*Last updated: October 27, 2026.*
