snapshot-paths

dbt_project.yml

snapshot-paths: [directorypath]

Definition

Optionally specify a custom list of directories where snapshots are located.

Default

By default, dbt will search for snapshots in the snapshots directory, i.e. snapshot-paths: ["snapshots"].

Paths specified in snapshot-paths must be relative to the location of your dbt_project.yml file. Avoid using absolute paths like /Users/username/project/snapshots, as they may lead to unexpected behavior.

• ✅ Do:

  # Recommended relative path example
  snapshot-paths: ["snapshots"]

• ❌ Don't:

  # Avoid using absolute paths
  snapshot-paths: ["/Users/username/project/snapshots"]

Examples

Use a subdirectory named archives instead of snapshots

dbt_project.yml

snapshot-paths: ["archives"]