Skip to main content

Explore multiple projects

View all the projects and public models in your account (where public models are defined) and gain a better understanding of your cross-project resources and how they're used.

On-demand learning

If you enjoy video courses, check out our dbt Explorer on-demand course and learn how to best explore your dbt project(s)!

The resource-level lineage graph for a project displays the cross-project relationships in the DAG, with a PRJ icon indicating whether or not it's a project resource. That icon is located to the left side of the node name.

To view the project-level lineage graph, click the View lineage icon in the upper right corner from the main overview page:

  • This view displays all the projects in your account and their relationships.
  • Viewing an upstream (parent) project displays the downstream (child) projects that depend on it.
  • Selecting a model reveals its dependent projects in the lineage.
  • Click on an upstream (parent) project to view the other projects that reference it in the Relationships tab, showing the number of downstream (child) projects that depend on them.
    • This includes all projects listing the upstream one as a dependency in its dependencies.yml file, even without a direct {{ ref() }}.
  • Selecting a project node from a public model opens its detailed lineage graph if you have the permissions to do so.
View your cross-project lineage in a parent project and the other projects that reference it by clicking the 'Relationships' tab.View your cross-project lineage in a parent project and the other projects that reference it by clicking the 'Relationships' tab.

When viewing a downstream (child) project that imports and refs public models from upstream (parent) projects:

  • Public models will show up in the lineage graph and you can click on them to view the model details.
  • Clicking on a model opens a side panel containing general information about the model, such as the specific dbt Cloud project that produces that model, description, package, and more.
  • Double-clicking on a model from another project opens the resource-level lineage graph of the parent project, if you have the permissions to do so.
View a downstream (child) project that importants and refs public models from the upstream (parent) project.View a downstream (child) project that importants and refs public models from the upstream (parent) project.

Explore the project-level lineage graph

For cross-project collaboration, you can interact with the DAG in all the same ways as described in Explore your project's lineage but you can also interact with it at the project level and view the details.

If you have permissions for a project in the account, you can view all public models used across the entire account. However, you can only view full public model details and private models if you have permissions for the specific project where those models are defined.

To view all the projects in your account (displayed as a lineage graph or list view):

  • Navigate to the top left section of the Explore page, near the navigation bar.
  • Hover over the project name and select the account name. This takes you to a account-level lineage graph page, where you can view all the projects in the account, including dependencies and relationships between different projects.
  • Click the List view icon in the page's upper right corner to see a list view of all the projects in the account.
  • The list view page displays a public model list, project list, and a search bar for project searches.
  • Click the Lineage view icon in the page's upper right corner to view the account-level lineage graph.
View a downstream (child) project, which imports and refs public models from upstream (parent) projects.View a downstream (child) project, which imports and refs public models from upstream (parent) projects.

From the account-level lineage graph, you can:

  • Click the Lineage view icon (in the graph’s upper right corner) to view the cross-project lineage graph.
  • Click the List view icon (in the graph’s upper right corner) to view the project list.
    • Select a project from the Projects tab to switch to that project’s main Explore page.
    • Select a model from the Public Models tab to view the model’s details page.
    • Perform searches on your projects with the search bar.
  • Select a project node in the graph (double-clicking) to switch to that particular project’s lineage graph.

When you select a project node in the graph, a project details panel opens on the graph’s right-hand side where you can:

  • View counts of the resources defined in the project.
  • View a list of its public models, if any.
  • View a list of other projects that uses the project, if any.
  • Click Open Project Lineage to switch to the project’s lineage graph.
  • Click the Share icon to copy the project panel link to your clipboard so you can share the graph with someone.
Select a downstream (child) project to open the project details panel for resource counts, public models associated, and more. Select a downstream (child) project to open the project details panel for resource counts, public models associated, and more.
0