Skip to content

Include

Includes break a project apart into multiple files by pulling other YAML files — or whole directories — into the root project file. Paths can point at local files or at files in remote GitHub repositories, which lets you share sources, models, and dashboards across projects.

Example

includes:
  - path: models/orders.yml
  - path: dashboards/
    depth: 1
    exclusions:
      - drafts/*

Read more about includes here

Attributes

Field Type Default Description
path string None The path or git reference to external yml files or directories to include in this project
depth integer None Directory traversal depth. None=fully recursive, 0=current directory only, 1=one level deep, etc. Only applies to directory paths.
exclusions array [] Patterns to exclude from directory inclusion. Supports glob patterns and regex. Only applies to directory paths.