Skip to main content
When you connect Unblocked with Linear, you’ll provide Unblocked with important context on how and why your codebase works. Most importantly, Unblocked will be able to use context from the projects, issues, and pages your team has in your Linear site to answer questions you ask it, and it will provide links back to the information that it used for easy reference. Unblocked connects to Linear through the Unblocked workspace app. You can also ask Unblocked to create Linear issues and add comments from chat.

Data sync

Unblocked receives updates from Linear in real time through webhooks, so new and updated issues and comments appear in answers shortly after they change. A scheduled sync also runs every 12 hours as a backstop to catch anything a webhook may have missed.

Connect your Linear workspace

Sign in to Unblocked

Whether you sign in with a source code manager or your SSO provider, you first need to authenticate to Unblocked. Once you’ve signed in, click Settings in the sidebar, then Data Sources. Click Connect Another and select Linear. From there, you’ll be redirected to Linear to sign in. Then, you’ll be asked to install the Unblocked workspace app. A Linear workspace admin must approve the installation.

Connect Unblocked to Linear

Make sure you have selected the correct Linear workspace from the top left menu, then approve the installation. You will then be redirected back to Unblocked, where you can select the teams you want Unblocked to access. We recommend providing access to All Teams in your Linear workspace. If you would like to select Specific Teams in Linear, Unblocked will use only those selected teams to answer the questions you ask. Linear-teams Click Save Settings, and Unblocked will immediately begin including these Linear resources when finding its answers for you.

Create issues and comments

Ask Unblocked in chat to create a Linear issue or add a comment to an existing issue. Explicitly ask it to publish the content. Unblocked does not write to Linear without that request. All issues and comments created through Unblocked use the workspace app. Linear shows the author as the Unblocked app or as your verified Linear name “via Unblocked”. The app does not take over your own Linear permissions. To write to Linear, you must meet all of these requirements.
  • You are a current member of the Unblocked team.
  • You have exactly one linked Linear identity for that workspace. You do not need your own personal Linear token.
  • You are a regular, active member of the Linear workspace. Guests are not supported.
  • The target team is active, connected to Unblocked, and included in the data source preset used for your chat.
  • You belong to the target team, or it is a public, top-level team that allows all members to join. Private teams and sub-teams require explicit membership.
You can only add comments to issues that are not archived or deleted.

Reconnect the workspace app

If the Linear settings page shows Reconnect Linear write access, the app’s access was revoked, expired, or is missing permissions. Click Reconnect workspace app and have a Linear workspace admin approve the authorization again. If you are not an Unblocked admin, click View Admins in the banner to find your team’s admins. Ask an admin to reconnect the app.

Troubleshooting

Chat does not offer Linear issue or comment creation

Open the Linear settings page. If you see Enable Linear write access or Reconnect Linear write access, ask an Unblocked admin to install or reconnect the app.

The app is connected, but you cannot create an issue or comment

Ask your admins to check your linked Linear account and access against the requirements above. If the target team is excluded from your chat’s data source preset, select a preset that includes it. If an issue is archived or deleted, choose another issue for your comment.

The workspace app connection fails

If you see “There was an error connecting the Linear workspace app. Please contact support for further assistance.”, contact support.

Upgrade a personal Linear connection

Workspaces connected before the Unblocked workspace app use a personal Linear account. A personal connection can only read, so Unblocked cannot create issues or comments, and routines cannot use Linear triggers. Upgrade to the workspace app to add write access. Your existing connection, team selection, and data sync stay in place.
  1. In Unblocked, click Settings in the sidebar, then Data Sources. Open the connected Linear workspace you want to upgrade.
  2. Find the Enable Linear write access banner at the top of the Linear settings page.
  3. Click Install workspace app.
  4. Unblocked redirects you to Linear. Have a Linear workspace admin approve the installation for the workspace you want to upgrade.
  5. Linear redirects you back to Unblocked. When the app is connected and can write, the banner goes away.
You also see Enable Linear write access if the workspace app was disconnected. Follow the same steps. If you are not an Unblocked admin, click View Admins in the banner to find your team’s admins. Ask an admin to install the app.