Using the + prefix
+ prefix is a dbt syntax feature, introduced in dbt v0.17.0, which helps disambiguate between resource paths and configs in
It is only compatible with
dbt_project.yml files that use `config-version: 2`
Throughout this documentation, we've tried to be consistent in using the
+ prefix in
However, the leading
+ is in fact only required when you need to disambiguate between resource paths and configs, for example when:
- A config accepts a dictionary as its inputs, for example, the
- Or, a config shares a key with part of a resource path, for example, if you had a directory of models named
+persist_docs: # this config is a dictionary, so needs a + prefix
schema: my_schema # a plus prefix is optional here
+tags: # this is the tag config
tags: # whereas this is the tag resource path
# The below config applies to models in the
# models/tags/ directory.
# Note: you don't _need_ a leading + here,
# but it wouldn't hurt.
When adding configs in
dbt_project.yml, it doesn't hurt to use the
+ prefix, so we recommend you use it always.