Skip to content

Repository default reviewers

See Global flags for JSON output and workspace/repository selection.

Default reviewers are auto-suggested when someone opens a pull request in Bitbucket’s web UI. This group reads and edits that list.

Terminal window
bb repo default-reviewers list [options]

By default the effective reviewer list is shown: reviewers configured directly on the repository and reviewers inherited from the parent project, matching what Bitbucket’s web UI would auto-populate.

Option Description
--repo-only Only show reviewers configured on the repository (exclude project-inherited)
Terminal window
# Effective list (repo + project-inherited)
bb repo default-reviewers list
# Only repo-level entries
bb repo default-reviewers list --repo-only
# JSON for scripting
bb repo default-reviewers list --json

--json emits { workspace, repoSlug, mode, count, reviewers }, where mode is effective or direct.

Terminal window
bb repo default-reviewers add <user>
Option Description
--dry-run Print the write request instead of sending it (details)

Adds a user as a default reviewer on the repository. Requires repository admin permission.

<user> accepts an account ID or a UUID in braces, not a nickname. See Identifying users for how to find these IDs.

Terminal window
bb repo default-reviewers add "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"
bb repo default-reviewers add "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"
Terminal window
bb repo default-reviewers remove <user> --yes
Option Description
--dry-run Print the write request instead of sending it (details)

Removes a user from the repository’s default reviewers. Without --yes it asks for confirmation in an interactive terminal and fails everywhere else (see --no-input). Requires repository admin permission.

<user> accepts the same identifiers as add (account ID or {uuid}).

Terminal window
bb repo default-reviewers remove "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f" --yes
  • Project-inherited reviewers can only be removed by editing the parent project, not the repository.
  • Related: bb pr create --default-reviewers applies these reviewers when opening a pull request.