Skip to documentation content

Review files

Approve or request changes on a stage's files.

Review states#

Each file's `review_status` is one of:

  • Pending — uploaded, not yet reviewed.
  • Approved — the reviewer has accepted it.
  • Changes Requested — the reviewer has asked for changes; the file is the new "to-do".

Approving#

Open the file from the stage's file list. If you are the configured reviewer (an internal employee or, on a client-review stage, the project's client), you'll see the Approve and Request Changes buttons.

Approving sets `review_status = Approved` and writes a `FileReviewLog` entry with your user, the timestamp, and any optional comment.

Requesting changes#

Use this when the file is wrong, incomplete, or needs work. You can attach a comment that explains what's needed; it goes into the `FileReviewLog` entry alongside your user and the timestamp.

After requesting changes, the file remains in the list with status `Changes Requested`. The author can re-upload a new version — that creates a fresh entry with status `Pending` and the cycle continues.