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

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

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.

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