Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lightdash.com/llms.txt

Use this file to discover all available pages before exploring further.

Whenever Lightdash writes changes back to your dbt project, it does so by opening a pull request (or merge request) in GitHub or GitLab. The Pull requests view in project settings collects all of these pull requests in one place, so you can see what’s in flight, what’s been merged, and where each change came from — without having to dig through your git provider.
  • Pull requests are only available for dbt projects connected to GitHub or GitLab. The view is hidden if your project doesn’t have a GitHub or GitLab integration.
  • You need to be at least a project Developer to view pull requests.

​
Accessing pull requests

To view the pull requests for your project:
  1. Click on the settings icon in the navigation bar
  2. Navigate to project settings
  3. Select pull requests from the menu
The table lists every pull request Lightdash has opened for the project, newest first.
The Pull requests table in project settings, showing each write-back pull request with its created time, user, title, source tag, state, and links

​
Understanding the pull requests table

Each row represents a pull request Lightdash created on your behalf. The table shows:
  • State: whether the pull request is open, merged, or closed. This status is fetched live from GitHub or GitLab, so it always reflects the current state of the pull request — even if it was merged or closed outside of Lightdash.
  • Created: when Lightdash opened the pull request, shown as a relative time.
  • User: the Lightdash user who triggered the write-back. If the user has since been removed from the organization, this is left blank.
  • Title & source: the title of the pull request, alongside a tag showing which feature created it (see Sources below).
  • Pull request link: opens the pull request directly in GitHub or GitLab.
  • Thread link: for pull requests opened by an AI agent, a link back to the agent thread that produced the change.
If a project has no pull requests yet, the table shows an empty state.

​
Sources

The source tag tells you which part of Lightdash opened the pull request:
SourceCreated by
Custom metricWriting back a Custom Metric to dbt
Custom dimensionWriting back a Custom Dimension to dbt
SQL runnerWriting back a model from the SQL runner
Source editorEditing your dbt project files from within Lightdash
AI agentA write-back triggered by a Lightdash AI agent

​
Live status

The title and state of each pull request are resolved on demand from your git provider, batched per repository. The stored pull request link always remains usable, so even if the live status can’t be fetched — for example, if the pull request was deleted, or Lightdash has lost access to the repository — you can still open the pull request directly from the table.

​
Permissions

Viewing pull requests requires the view source code permission, which is granted to project Developer and above. See roles and permissions for more information about access levels.