Linear Integration

Learn to integrate Featurebase with Linear and the key features.

BfF

Written By Bruno from Featurebase

Last updated 15 days ago

Overview

The Featurebase Linear integration enables you to turn new feedback from Featurebase into actionable Linear issues. You can sync the statuses between the two and keep users automatically updated about the development of their ideas.

Key features:

  • Two-way-sync the statuses between Linear and Featurebase posts

  • Manually push Featurebase posts to Linear and vice versa

  • Link Featurebase posts to existing Linear issues or projects

  • Sync due dates of projects and issues from Linear to Featurebase

  • Keep users automatically updated about their request’s status

Example: New feedback from Featurebase automatically gets pushed to Linear for your engineers. After they complete the feature and change the issue status in Linear (e.g. Planned → Completed), it will automatically update the post in Featurebase, and all upvoted users will be notified by email.


Setting up the Linear integration

1. Install the Linear integration

  1. In Featurebase, go to Settings → Integrations

  2. Click on Connect to Linear

  3. Next, click on Authorize Featurebase from Linear.

  4. Once connected, click on the Configure Linear button in the same place

  5. Now configure the integration:

    • Select a default team

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

    • Choose if you want to automatically push new Featurebase posts to Linear

2. Create 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.

  1. In Featurebase, go to Settings → Integrations and click on Configure Linear

  2. Start by clicking on New Issue Rule or New Project Rule in the bottom right

  3. Choose the Featurebase and Linear status to sync with each other. We recommend creating a rule for every Featurebase status you actively use.

  4. Then select the sync direction

  1. Select whether to notify users about the status change. (If set to Notify, all upvoters will receive an email if you change the status in Linear)

And that's it! Linked posts should sync perfectly from now on.


How to use

1. Push Linear issues to Featurebase

You can push existing Linear issues to Featurebase to start collecting feedback for them:

  1. In Linear, select the issues you’d like to push to Featurebase

  2. Add the ‘“Featurebase” label to them

You can also do the same when creating a new post - just add the label during creation. The importing will respect the rules you configured earlier in this tutorial.

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

2. Push Linear projects to Featurebase

To push Linear projects to Featurebase, you need a sync rule between the Linear project and a Featurebase post.

Then, if you change the status of any of your Linear projects or create a new one, a post will be automatically created in Featurebase.

Don't worry - you still have full control over what is shown publicly. All projects will be pushed into the Moderation tab, where you can approve what is 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 from your internal one.

3. Pushing posts from Featurebase to Linear

If you did not set up automatic pushing from Featurebase to Linear, you can push only selected posts for more control:

  1. In Featurebase, simply open up the post

  2. Click the Linear icon on the top right

  3. Select ‘Create new issue

You can quickly see the new issue in Linear by pressing the same Linear icon and clicking “View linked issue

4. Link Featurebase posts to existing Linear issues

Linking Featurebase posts to existing Linear issues is essentially the same:

  1. In Featurebase, simply open up the post

  2. Click the Linear icon on the top right

  3. Select ‘Link to existing issue

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

You can unlink the issue from the same place if needed.


That's it! 🎉 If you have any ideas about how we can improve the Linear integration, please post on our feedback board.

FAQ