Learn to integrate Featurebase with Linear and the key features.
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
In Featurebase, go to Settings → Integrations
Click on Connect to Linear
Next, click on Authorize Featurebase from Linear.
Once connected, click on the Configure Linear button in the same place
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.
In Featurebase, go to Settings → Integrations and click on Configure Linear
Start by clicking on New Issue Rule or New Project Rule in the bottom right
Choose the Featurebase and Linear status to sync with each other. We recommend creating a rule for every Featurebase status you actively use.
Then select the sync direction
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:
In Linear, select the issues you’d like to push to Featurebase
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:
In Featurebase, simply open up the post
Click the Linear icon on the top right
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:
In Featurebase, simply open up the post
Click the Linear icon on the top right
Select ‘Link to existing issue’
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.