Commit a file named .veridical.yaml (or .veridical.yml) at the repository
root. When both exist, only .veridical.yaml is read. Every key is optional:
Where Veridical reads it
Veridical reads the file from the pull request’s base branch, never from the
pull request’s own changes, so a pull request cannot change how it is reviewed.
A change to the file takes effect once it is merged into the base branch.
Mistakes in the file
A malformed file, a key Veridical does not know, or a value of the wrong type is
ignored; it never stops a review. If a setting seems to have no effect, check
the file on the base branch.
The merge gate is the one setting the review reports on: if Veridical does not
understand the auto_merge setting, the gate stays off, no safe-to-merge check
is posted, and the review summary says the setting was not understood.
Files left out by path_filters still count toward the pull request’s size. See
How reviews are counted. Last modified on November 17, 2026