Linear Integration

Use widgets and public forums to capture feedback for Linear issues, publish a public roadmap & notify customers about development progress.

BfF

Written by Bruno from Featurebase

Last updated 11 days ago

Our Linear integration is incredibly powerful and fits incredibly well into your workflow, here's everything that's supported:

  • Connecting Linear issues or projects to Featurebase feedback posts

  • Two-way-syncing statuses between Linear <-> Featurebase

  • Pushing feedback from Featurebase -> Linear

  • Pushing issues or projects in Linear -> Featurebase

  • Syncing Due dates of projects and issues from Linear -> Featurebase

I'm going to walk you through all the steps of setting up the integration in just a couple of minutes.

Step 1. Connect your Linear account

Go to Dashboard -> Settings -> Integrations and click on 'Connect to Linear'.

Next, click on Authorize Featurebase from Linear. It should redirect you back to the dashboard after that. If the Linear button says 'Configure Linear', you have successfully connected Featurebase with Linear.

Step 2. Configure Linear

Once connected, click on the Configure Linear button.

There are a couple of important settings to configure.

  1. Select a default team.

  2. Choose what happens when you delete a linked linear issue.

  3. Choose if you want to automatically push new Featurebase posts to Linear

Step 3. Creating sync rules

Sync rules are used for two-way-syncing statuses between Featurebase posts and Linear issues or projects.

This is the most important part of setting up the integration. Syncing between Featurebase and Linear will only work if you set up the rules correctly.

Go to Dashboard -> Settings -> Integrations and click on Configure Linear.

Start by clicking on Create Rule in the bottom right.

You will now have to choose a Featurebase status and a Linear status to sync with each other. After selecting both of those, you can also select the sync direction.

The direction can be either:

  • Bidirectional (Recommended)

    • When a status is updated in either Featurebase or Linear, it will simultaneously reflect in the other platform.

  • Featurebase -> Linear

    • When a status is changed in Featurebase, it will also reflect in Linear. On the other hand, a change in status within Linear will not affect Featurebase.

  • Linear -> Featurebase

    • When a status is changed in Linear, it will also reflect in Featurebase. On the other hand, a change in status within Featurebase will not affect Linear.

After selecting the direction, select whether to notify users when you change the status in Linear. If set to Notify, all upvoters will receive an email if you change the status in Linear.

We recommend creating a rule for every Featurebase status you actively use.

Extra features:

Push Linear issues to Featurebase

With the Linear integration, you can push issues you already have in Linear to Featurebase to start collecting feedback for them.

To get started, simply select the issues you would like to add to Featurebase & attach a "Featurebase" label to them in Linear.

For new organizations, the "Featurebase" label is included by default.

The importing will respect the rules you configured earlier in this tutorial.

This also works when you create a new post in Linear.

Simply include the "Featurebase" label, and it will be pushed to Featurebase:

If you're pushing over 300+ posts to Featurebase, expect there to be some delay for the Linear issues to get a link back to Featurebase, as we have to wait to not get rate-limited by the Linear API.

Push Linear projects to Featurebase

If you change the status of any of your Linear projects or create a new one, then a post will be automatically created in Featurebase if you have a sync rule configured for that status.

Don't worry, you still have full control over what gets shown publicly.

All projects will be pushed over in a Post moderation status, so you can approve what gets shown to everyone.

It will pull in the Title and Description of your Linear Project and you can always change it in Featurebase to make it different than your internal one.

Pushing posts from Featurebase to Linear

If you did not set up automatic pushing from Featurebase -> Linear, then you can push only selected posts for more control.

Go to a post you wish to send to Linear, click the Linear logo on the top right, and select "Create new issue".

Modify the title/content to your liking and press the Push to Linear button to send it there.

Link existing Linear issues with a Featurebase post (from Featurebase)

Any existing Linear issue can be linked to a Featurebase post either from Linear (By adding the Featurebase label) or from Featurebase with the following steps:

Go to the post you wish to link with a Linear issue, click the Linear button in the top right, then select "Link to existing issue".

Search for the Linear issue using the search bar and click Link to Issue.