Skip to main content
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