ProductZip - Product portfolio management software

Interlinking

Automate your pull request and commit workflows and keep issues synced both ways

View looking up at a circular, symmetric ceiling structure with radial beams and rectangular light fixtures forming a spiral pattern.

A single shortcut to assign yourself an issue, mark it as In Progress, and copy the git branch name to your clipboard

Overview

Linear's GitHub integration keeps your work in sync in both applications. It links issues to Pull Requests and commits so that issues update automatically fromIn ProgresstoDoneas the PR moves from drafted to merged – there is no need to update the issue in Linear at all.

Issues created on GitHub can be synced across to Linear automatically, and comments and other updates are reflected both ways. Move even faster by using a keyboard shortcut that creates the issue's git branch name, assigns the issue and moves the issue toIn Progressin one step.

‍

How it works

Configure the GitHub integration in a couple of minutes by authenticating and selecting which repos to connect to Linear. Once you do, anyone in the workspace can start linking PRs and commits.

Link PRs and commits to issues in a few ways. Use theissue IDin the branch name or PR title before creating the PR. To link multiple PRs, or link issues after creating the PR, use magic words along with theissue IDin the PR description or commit message. This will create a link to the PR in the Linear issue and a linkback to Linear from the PR.Set workflow automations on a per team basis so that issues move through different issue statuses based on PR/commit status. Turn on a couple of account preferences settings to enable personal GitHub automations that auto-assign issues and move them toIn Progress.

Connect your chosen repos to sync newly created GitHub issues to your desired teams on Linear —useful for open source projects. Comments, status, assignee and other states are synced both ways between Linear and GitHub.

‍

Configure

A Linear admin can enable this integration for the workspace in settings. GitHub PR linking and linking via commits are enabled separately.

Once enabled, any workspace member can see and configure PR automation under team workflow settings and personal git automations under account preferences. Learn about advanced configuration options to enable autolink or to connect a GitHub Enterprise Cloud account.

GitHub issues can be linked to your repository and Linear team from the GitHub issues section and this will send any new GitHub issues into Linear automatically and already synced.

Self-hosted GitHub Enterprise Server is available asits own integration.