Vaiz
Sign upBook a demo
Help center
Tutorials

How to set up the GitHub integration in Vaiz

GitHub integration lets you connect repositories to Vaiz tasks, link pull requests, branches, and commits, and keep development activity visible alongside project work. You can also create Git branches directly from tasks.

Step 1. Connect GitHub to your space

Click the space icon in the top-left corner, select the space you want to connect, and choose App center.

Opening App Center from the space menu in Vaiz

In the App Center, click GitHub.

Selecting GitHub in the Vaiz App Center

Note: To connect Zapier, see the Zapier setup guide. For Slack, see the Slack integration guide.

GitHub integration page in Vaiz with Connect button highlighted

On the GitHub integration page, click Connect.

Confirmation dialog for adding GitHub to a Vaiz space

Review the setup information and click Confirm.

GitHub sign-in page during Vaiz integration setup

If you are not signed in to GitHub, you will be redirected to the GitHub sign-in page. Enter your username and password to continue.

Installing the Vaiz app on GitHub with repository access and permissions

After the installation is complete, GitHub will automatically redirect you back to the integration flow. Click Confirm to finish connecting the account.

Final confirmation dialog to complete GitHub connection in Vaiz

If the connection is successful, you will see a confirmation message. Click Back to App to finish.

GitHub successfully connected to Vaiz confirmation screen

Step 2. Use GitHub features in Vaiz

After the connection is complete, the GitHub account appears on the integration page with the Connected status.

The integration page also shows the available features:

  • Repositories: connected GitHub repositories available for linking to tasks.
  • PR Comments & Activity: GitHub pull request comments and updates are mirrored into linked Vaiz tasks.
  • Task Activity to PRs: Vaiz task status changes are posted as comments on linked GitHub pull requests.
  • Create Branches: new branches can be created in connected repositories directly from tasks.

PR Comments & Activity and Task Activity to PRs can be turned on or off using the toggles on the right side of each feature.

GitHub integration page in Vaiz showing connected account and feature toggles

After GitHub is connected, tasks from connected repositories include a GitHub field.

GitHub field on a Vaiz task ready to link pull requests, branches, or commits

Click the GitHub field to link a pull request, branch, or commit to the task.

GitHub entity linking panel on a Vaiz task with tabs for PR, branch, commit, and create branch

You can also create a new branch from the task.

Creating a new GitHub branch directly from a Vaiz task

Step 3. Manage the integration

You can manage connected GitHub accounts from the GitHub page in the App Center.

  • To add one more account, click Connect another account and repeat the connection flow.
  • To manage an existing connection, click the three-dot menu next to the connected account.

From this menu, you can open GitHub settings or disconnect the account from the current Vaiz space.

Managing a connected GitHub account in Vaiz with options to manage on GitHub or disconnect

If you select Manage on GitHub, you will be redirected to the GitHub installation settings. There, you can update repository access, suspend the installation, or uninstall the Vaiz GitHub app.

Vaiz app settings on GitHub showing repository access, permissions, and options to suspend or uninstall