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 the due dates of projects and issues from Linear to Featurebase

• Keep users automatically updated about their request’s status

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

   Different syncing direction options explained

   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.

5. 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.

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. Now, if you change the status of your Linear project or create a new one, a post will be automatically created in Featurebase.

You’ll 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 or projects

Linking Featurebase posts to existing Linear issues or projects 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 or project’

4. Search for the Linear issue or project using the search bar and click Link.

You can unlink the issues from the bottom of the post content section 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

Are posts made before the integration setup also automatically synced into Linear?

No, posts created in Featurebase before setting up the Linear integration will not be automatically synced.

You can manually push existing posts to Linear after the integration is configured by opening the post in Featurebase, clicking the Linear icon in the top-right corner, and selecting “Create new issue” or linking it to an existing Linear issue.