Skip to main content

Setting up Code Review

To set up Code Review for your Unblocked team, select Code Review from the left sidebar. Next, click Set Up Code Review. If you haven’t connected your issue tracker, you’ll be prompted to do so. Enable Code Review

Configure Code Review

Once Code Review is enabled, you can adjust the settings to control how reviews are conducted. Click Settings in the sidebar, then select Code Review.

Select repositories

Unblocked will automatically review pull requests only for repositories you select. Select Repositories

Select a bot account

This step is only required for GitLab repositories.

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

Create a bot account

Already have a bot account?

Some teams already have a bot account they use for posting automated messages. If you already have a bot account that you can repurpose for posting code review comments, skip to the next step to select it.

  • Create a new account in GitLab.
  • In GitLab, click on your avatar in the top right, and click Edit Profile.
  • Change the following information:
    • Name: Unblocked
    • Avatar: download and use the Unblocked logo below Unblocked logo
  • Sign out of your GitLab bot account.
  • Sign in as a Group admin for your GitLab Group and navigate to it.
  • Click Manage in the left navigation and select Members.
  • Click Invite members
  • Set the role as “Planner” or above and click “Invite”.
2

Select your bot account

In Unblocked, click Select a Bot Account for your GitLab Group. Next, 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 GitLab.
Select Bot

Excluded paths

You can configure custom path exclusion patterns to exclude specific files or directories from review. These patterns use glob syntax and are applied when processing pull requests. Common exclusion patterns include *.md to exclude all Markdown files at any depth, src/test/** to exclude all files under a specific directory from the repository root, and package-lock.json to exclude specific files. You can also exclude entire directories like node_modules/** or file types like *.generated.js. Exclusion Patterns

Code Review user access

Use the Code Review User Access setting to control which users are eligible to receive automated code reviews. By default, All Users is selected, so Unblocked will review pull requests for everyone in your workspace. To limit reviews to specific people, choose Specific Users and select the users you want from the list. Only pull requests authored by those users will receive automated code reviews. Users who are not selected can still request a review manually by mentioning @unblocked in a PR comment. See Requesting a review for details. User Access