Product GuideChangelogCommunity DiscordDiscussionsBlogGitHub
Log In

Install Reviewpad GitHub Action with a GitHub Token

This guide describes the setup for Reviewpad GitHub Action with a GitHub Token.


By default a GitHub Action runs with an automatic token generated and provided by GitHub.

Although this generate token is enough to run most of Reviewpad functions, there are functions that need more permissions to run. An example is the function $team that requires access to the organizations' members.

All functions that require a GitHub Token to be provided are marked with the following message:

:warning: Requires a GitHub token :warning:

Therefore in order to setup Reviewpad GitHub Action with a GitHub Token, follow the following steps:

Step 1. Generate a GitHub token

In order to do that, please follow GitHub tutorial. Don't forget to save the token. We will use it in the next step.

Make sure that you give the following permissions when generating the token:

Step 2. Add the generated GitHub token to Actions Secrets

  1. Go to your GitHub project (the project where you want the Reviewpad Action to run)
  2. Select the tab Setting
  3. On the left select Actions under Secrets
  4. Click the button New Repository Secret
  5. Add the new secret and then click on Add secret
    • Name: GH_TOKEN

Step 3. Open the GitHub project on your IDE

Open the GitHub project where you wish to install the Reviewpad Action with your IDE.

This is necessary because we will be adding and committing new files to the repository.

Step 4. Add Reviewpad Action workflow file

At the root of your repository navigate to .github > workflows (This is where your project actions live. If you don't have these folders, please create them).

Add the file reviewpad.yml with the following content:

name: Reviewpad Action


    runs-on: ubuntu-latest
      - name: Running reviewpad action
        uses: reviewpad/[email protected]
          token: ${{ secrets.GH_TOKEN }}

We just added Reviewpad as a GitHub action. We now need to add you're project configuration of Reviewpad.

Step 5. Add reviewpad.yml to the root of the repository

Reviewpad is extremely configurable. You can use it to automate PR labelling or comment when something is not right. It all depends on your project requirements. You can later check the documentation to see all you can do with Reviewpad.

For now let's add a simple configuration. For that navigate to the root of your repository and add a new file named reviewpad.yml with the following content:


    name: "small"
    description: Small changes
    # color is the hexadecimal color code for the label, without the leading #.
    color: "294b69"
    name: "medium"
    description: Medium changes
    color: "a8c3f7"
    name: "large"
    description: Large changes
    color: "8a2138"

  - name: isSmall
    kind: patch
    description: Small pull request
    spec: $size() <= 30

  - name: isMedium
    kind: patch
    description: Medium sized pull request
    spec: $size() > 30 && $size() <= 100

  - name: isLarge
    kind: patch
    description: Large sized pull request
    spec: $size() > 100

  - name: label-pull-request-with-size
    description: Label pull request with size
      - rule: isSmall
          - $addLabel("small")
      - rule: isMedium
          - $addLabel("medium")
      - rule: isLarge
          - $addLabel("large")

This particular configuration will ask Reviewpad to label you PRs based on their size.

You can do much more with Reviewpad. Start by looking at some of Reviewpad use cases or jump right into the available builtins.

️ Terms and Conditions

By running this action you’re agreeing with Reviewpad’s Terms and Conditions.


We are looking for contributors 💪

Join our discord community.

Did this page help you?