This feature may not be available by default and might need to be enabled upon request. Please contact your account manager for more information.
Gain complete, end-to-end visibility into how data models and shared objects connect across every project in your entire organization from a single, centralized view. With the Global Lineage view, teams can eliminate guesswork and prevent costly downstream breaking changes before making schema updates. Search, explore, discover: this unified perspective breaks down organizational silos and gives teams a single pane of glass for object sharing across logical, physical, and business domains.
The view is built entirely from existing global references and follows the same plan availability as Global modeling. It is read-only: to add, change, or remove a reference, work inside the relevant project as usual.
Opening Global lineage
Global lineage is opened from the Dashboard. Click the home icon in the left navigation to open the Home menu and choose "Global lineage." The view covers the whole account.
Additionally, jump to the Global Lineage screen from inside a project using the shortcut provided in the "Global reference summary."
Reading the lineage view
Every project in the account that takes part in a global reference is shown, regardless of who owns it or whether you are a member of it.
Each active global reference is drawn as a dashed connection from the project that shares the object (the parent project) to the project that uses it (the child project). The arrow always points toward the project that uses the object, so you can read the flow of data along the arrows. Lineage is transitive: if project A is referenced by project B, and B is referenced by project C, you can follow the chain A → B → C in one view.
The view reflects the latest revision of every project. Inactive references, and references to objects that no longer exist in the parent project's latest revision, are not shown.
By default, every project is collapsed into a single project node. A project node shows the expand control, the database type, the project name, and two counts: shared (objects this project shares with other projects) and used (global objects it brought in from other projects).
When both projects are collapsed, all the object-level references between them merge into one connection. A badge on the connection shows how many references it represents; a connection without a badge represents a single reference.
Expanding and collapsing projects
Click the "+" on a project node (or double-click the node) to expand it. An expanded project shows only the objects that take part in global references: the objects it shares with other projects and the global objects it uses. Objects without a global reference are not shown. Each object node shows the object name, qualified with its schema.
When one project is expanded and the other is collapsed, the connections run from each object to the collapsed project node.
When both projects are expanded, every reference is drawn as its own object-level connection, so you can see exactly which object feeds which. Connections keep their direction at every level of collapse.
Click "−" to collapse a project back into a single node. "Expand all" and "Collapse all" in the toolbar do the same for every project at once.
Inspecting projects, objects, and connections
Click a project node to select it. Its connections are highlighted, the project is highlighted in the Projects panel, and the "Project properties" panel opens on the right. It shows the project's name, folder, and database type, the number of objects it shares and uses, and two shortcuts: "Open project in new tab" and "Expand project" (or "Collapse project" when the project is already expanded).
"Open project in new tab" works for any project in the view, including projects you don't own or belong to. If you don't have access to the project, you will see the standard "project not found" page instead.
Click an object node to open "Object properties": the object's name, database, and schema, the project it belongs to, and, under "Sharing," the project that shares the object ("Shared by") and the project that uses it ("Used by").
Click a connection, or its count badge, to open "Sharing details." It lists every reference the connection represents, with the sharing and using project for each one.
Click an empty spot on the canvas, or the » button in the panel header, to clear the selection and close the panel.
Searching
Type in the "Search projects and objects…" box above the Projects panel to find a project or object by name. Search is not case sensitive and matches any part of the name. The panel shows how many matches were found and lists only the matching projects and objects. On the canvas, matching objects are highlighted, and the projects that contain them expand so the objects become visible. Click a match in the list to center the canvas on it.
Navigating the canvas
Drag an empty area of the canvas to pan, and use the mouse wheel or the "+" and "−" buttons in the top-left corner of the canvas to zoom. The toolbar next to the view title offers "Reset zoom" (back to 100%), "Zoom to fit" (fit every project on the screen), and "Refresh" (reload the view with the latest references from your projects).
"Zoom to fit" is a good way to get a picture of the whole account before you drill into a particular project. The minimap in the bottom-right corner of the canvas shows which part of the diagram you are looking at; click the arrow in its corner to hide or show it.
When there are no global references yet
If no project in the account uses global references, the view is empty and explains how to get started: enable Global modeling on a project and reference its objects from another project. See the "Global Modeling - Overview" article for the steps.