Set up and configuration

​

Setting up Code Review

​

Configure Code Review

​

Select repositories

​

Code Review user access

​

Deep Review

​

Approval workflow

• Risk Assessment — learn how to define risk policies that Unblocked evaluates against every pull request.
• Comment — post a comment when no issues are found. Turn this off if you want Unblocked to take no action on pull requests that do not qualify for auto-approval.
• Auto-approve low risk Pull Requests — approve pull requests that have no issues and a risk score of low or lowest. This setting appears when your source control integration supports approvals that count toward pull request requirements.
• Legacy Approvals — approve pull requests that have no issues for GitHub organizations whose Unblocked integration does not have the contents:write permission. These approvals do not count toward required approvals.

​

Custom rules

AGENT.md
AGENTS.md
AGENTS.override.md
ARCHITECTURE.md
CLAUDE.md
CODE_STYLE.md
CONTRIBUTING.md
CONVENTIONS.md
GEMINI.md
replit.md
STYLE.md
STYLEGUIDE.md
TESTING.md

.augment-guidelines
.clinerules
.continuerules
.cursorrules
.goosehints
.roorules
.rules
.windsurfrules

.claude/CLAUDE.md
.gemini/styleguide.md
.github/copilot-instructions.md
.idx/airules.md
.junie/guidelines.md
.vscode/cody.json

**/AGENT.md
**/AGENTS.md
**/AGENTS.override.md
**/CLAUDE.md
**/GEMINI.md
**/.agents/*.md
**/.rules/*

​

Examples

• “Use event.id for idempotent event processing.”
• “In customer-facing views, format dates with formatNorthstarDate and the account’s timezone.”
• “Use Money for monetary values; avoid floating-point arithmetic.”

• “Review API changes carefully.”
• “Check for security and correctness issues.”
• “Make sure database changes are safe.”

​

Excluded paths

​

Select a bot account

• Azure DevOps
• Bitbucket Cloud
• Bitbucket Data Center
• GitLab Cloud
• GitLab Self-Managed

For Azure DevOps repositories, code review comments need to be posted on behalf of an Azure DevOps user account. We recommend creating an Unblocked bot account for this specific purpose.

1

Create a bot account

• In the Microsoft Entra admin center, go to Entra ID > Users.
• Click New user, then select Create new user.
• Create a new user with the following information:
  • Name: Unblocked
  • Avatar: download and use the Unblocked logo below Download PNG
• In Azure DevOps, sign in to your organization as a Project Collection Administrator.
• Click Organization settings > Users, then click Add users.
• Enter the bot user’s email address.
• Set Access level to Basic.
• Under Add to projects, select each project where Unblocked should review pull requests.
• Set Azure DevOps Groups to Project Contributors.
• Click Add.

2

Select your Bot Account

In Unblocked, search for the bot account you just created and select it. You may be required to authorize this account with Unblocked.

In order to successfully authorize your bot account, you need to be logged in with that account in Azure DevOps.

For Bitbucket Cloud repositories, code review comments need to be posted on behalf of a Bitbucket user account. We recommend creating an Unblocked bot account for this specific purpose.

1

Create a bot account

• Create a new account in Bitbucket with the following information:
  • Name: Unblocked
  • Avatar: download and use the Unblocked logo below Download PNG
• Switch accounts and sign in to your Bitbucket Workspace as a Workspace admin.
• Click the gear icon in the top right of the navigation bar, and select User Management.
• Invite your new bot user to your workspace.
• Accept the email invitation that was sent to your bot account.

2

Select your Bot Account

In Unblocked, search for the bot account you just created and select it. You may be required to authorize this account with Unblocked.

In order to successfully authorize your bot account, you need to be logged in with that account in Bitbucket Cloud.

For Bitbucket Data Center repositories, code review comments need to be posted on behalf of a Bitbucket Data Center user account. We recommend creating an Unblocked bot account for this specific purpose.

1

Create a bot account

• Sign in as an administrator in your Bitbucket Data Center instance.
• In the top navigation bar, click the admin icon.
• Under Accounts, select Users, then Create user.
• Create a new user account in Bitbucket Data Center with the following information:
  • Name: Unblocked
  • Avatar: download and use the Unblocked logo below Download PNG
• Before the bot can access a project, it must be able to sign in to Bitbucket Data Center.
  • Go to Administration > Users.
  • Find your bot user and ensure it is assigned to a group.
  • Go to Administration > Global Permissions.
  • Ensure that group has the Bitbucket User permission.
• For each project Unblocked should review, navigate to Project settings > Permissions.
  • Add the bot user and set the permission as “Developer” or above.

2

Select your Bot Account

In Unblocked, search for the bot account you just created and select it. You may be required to authorize this account with Unblocked.

In order to successfully authorize your bot account, you need to be logged in with that account in Bitbucket Data Center.

For GitLab Cloud repositories, code review comments need to be posted on behalf of a GitLab account. We recommend creating an Unblocked bot account for this specific purpose.

1

Create a GitLab account for code review

You can use either a GitLab service account or a regular GitLab user account. Regular users connect with OAuth, while service accounts connect with a token. Decide which GitLab account type Unblocked should use for code review, then follow the matching instructions.GitLab service account

• Create a GitLab service account for the top-level group.
• Create a token for the service account:
  • From the service account page, select Manage access tokens.
  • Click Add new token.
  • Select the api and read_user scopes.
  • Click Generate token and copy the token.

Regular GitLab user account

• Create a new account in GitLab.
• In GitLab, set the regular user’s profile information:
  • Name: Unblocked
  • Avatar: download and use the Unblocked logo below Download PNG

2

Add the code review account to your GitLab top-level group

• In GitLab, sign in as an Owner for the top-level group that contains the repositories Unblocked should review.
• In the top-level group, click Manage in the left navigation and select Members.
• Click Invite members.
• Invite the GitLab account you created for code review.
• Set the role as “Developer” or above and click “Invite”.

3

Select the code review account in Unblocked

In Unblocked, search for the GitLab account you created for code review and select it. If you select a regular user account, Unblocked will prompt you to authorize that account with GitLab. If you select a service account, Unblocked will prompt you to enter the token you created in GitLab.

Service accounts connect with a token and do not use the GitLab OAuth flow. Regular user accounts still use OAuth, so you need to be logged in to GitLab with that account when authorizing it.

For GitLab Self-Managed repositories, code review comments need to be posted on behalf of a GitLab account. We recommend creating an Unblocked bot account for this specific purpose.

1

Create a GitLab account for code review

You can use either a GitLab service account or a regular GitLab user account. Regular users connect with OAuth, while service accounts connect with a token. Decide which GitLab account type Unblocked should use for code review, then follow the matching instructions.GitLab service account

• Create a GitLab service account in your GitLab instance.
• Create a token for the service account:
  • From the service account page, select Manage access tokens.
  • Click Add new token.
  • Select the api and read_user scopes.
  • Click Generate token and copy the token.

Regular GitLab user account

• Create a new account in your GitLab instance.
• In GitLab Self-Managed, set the regular user’s profile information:
  • Name: Unblocked
  • Avatar: download and use the Unblocked logo below Download PNG

2

Add the code review account to your GitLab top-level group

• In GitLab Self-Managed, sign in as an Owner or instance administrator for the top-level group that contains the repositories Unblocked should review.
• In the top-level group, click Manage in the left navigation and select Members.
• Click Invite members.
• Invite the GitLab account you created for code review.
• Set the role as “Developer” or above and click “Invite”.

3

Select the code review account in Unblocked

In Unblocked, search for the GitLab account you created for code review and select it. If you select a regular user account, Unblocked will prompt you to authorize that account with GitLab Self-Managed. If you select a service account, Unblocked will prompt you to enter the token you created in GitLab.

Service accounts connect with a token and do not use the GitLab OAuth flow. Regular user accounts still use OAuth, so you need to be logged in to GitLab with that account when authorizing it.