View documentation

dbt provides intuitive and scalable tools for viewing your dbt documentation. Detailed documentation is essential for your developers and other stakeholders to gain shared context for your dbt project.

You can view documentation in two complementary ways, depending on your needs:

Option	Description	Availability
dbt Docs	Generates a static website with model lineage, metadata, and documentation that can be hosted on your web server (like S3 or Netlify).	dbt Core or dbt Cloud Developer plans
dbt Explorer	The premier documentation experience in dbt Cloud. Builds on dbt Docs to provide a dynamic, real-time interface with rich metadata, customizable views, deep insight into your project and resources, and collaborative tools.	dbt Cloud Team or Enterprise plans

Navigating your documentation

The following sections describe how to navigate your documentation in dbt Explorer and dbt Docs.

dbt Explorer teamenterprise

dbt Explorer offers a dynamic, interactive way to explore your models, sources, and lineage. To access dbt Explorer, navigate to the Explore option in the dbt Cloud navigation menu.

Example of dbt Explorer's resource details page and its lineage.

Access dbt Explorer from dbt Cloud by clicking Explore in the navigation.

dbt Explorer offers users a comprehensive suite of features to enhance data project navigation and understanding, like:

• Interactive lineage visualization for your project's DAG to understand relationships between resources.
• Resource search bar with comprehensive filters to help find project resources efficiently and quickly.
• Model performance insights to access metadata on dbt Cloud runs for in-depth analysis of model performance and quality.
• Project recommendations with suggestions to improve test coverage and documentation across your data estate.
• Data health signals to monitor the health and performance of each resource through data health indicators.
• Model query history to track consumption queries on your models to gain deeper insights into data usage.
• Auto-exposures to automatically expose relevant data models from tools like Tableau to enhance visibility.

For additional details and instructions on how to explore your lineage, navigate your resources, view model query history and data health signals, feature availability, and more — refer to Discover data with dbt Explorer.

dbt Docs

dbt Docs provides valuable insights into your dbt Core or dbt Cloud Developer plan projects. The interface enables you to navigate to the documentation for specific models. That might look something like this:

Auto-generated documentation for a dbt model

Here, you can see a representation of the project structure, a markdown description for a model, and a list of all of the columns (with documentation) in the model.

From the dbt Docs page, click the green button in the bottom-right corner of the webpage to expand a "mini-map" of your DAG. This pane displays the immediate parents and children of the model that you're exploring.

Opening the DAG mini-map

In this example, the fct_subscription_transactions model only has one direct parent. By clicking the "Expand" button in the top-right corner of the window, we can pivot the graph horizontally and view the full lineage for our model. This lineage is filterable using the --select and --exclude flags, which are consistent with the semantics of model selection syntax. Further, you can right-click to interact with the DAG, jump to documentation, or share links to your graph visualization with your coworkers.

The full lineage for a dbt model

Deploy the documentation site

Effortlessly deploy documentation in dbt Explorer or dbt Docs to make it available to your teams.

Security

The dbt docs serve command is only intended for local/development hosting of the documentation site. Please use one of the methods listed in the next section (or similar) to ensure that your documentation site is hosted securely!

dbt Explorer teamenterprise

dbt Explorer automatically updates documentation after each production or staging job run using the metadata generated. This means it always has the latest results for your project with no manual deployment required. For details on how dbt Explorer uses metadata to automatically update documentation, refer to Generate metadata.

To learn how to deploy your documentation site, see Build and view your docs with dbt Cloud.

dbt Docs

dbt Docs was built to make it easy to host on the web. The site is "static," meaning you don't need any "dynamic" servers to serve the docs. You can host your documentation in several ways:

• Host on Amazon S3 (optionally with IP access restrictions)
• Publish with Netlify
• Use your own web server like Apache/Nginx
• If you're on a dbt Cloud Developer plan, see Build and view your docs with dbt Cloud to learn how to deploy your documentation site.

For a more seamless experience, use dbt Explorer as the recommended documentation experience in dbt Cloud.