Linear Integration
Learn to integrate Featurebase with Linear and the key features.
Written By Bruno from Featurebase
Last updated 4 days ago
Overview
The Featurebase ↔ Linear integration lets you turn customer feedback into actionable Linear issues and keep their statuses in sync. As work progresses in Linear, Featurebase automatically updates the related posts and notifies users about changes.
You can sync issues across multiple Linear teams and define different sync rules for different Featurebase boards. This gives you full control over how feedback moves through your workflow as your product and teams scale.
Key features:
Two-way sync of statuses between Linear and Featurebase posts
Manually push Featurebase posts to Linear issues or projects, and vice versa
Link Featurebase posts to existing Linear issues or projects
Sync due dates from Linear issues and projects to Featurebase
Automatically notify users when the status of their request changes
Example: New feedback in Featurebase is automatically pushed to Linear for your engineers. When the issue status is updated in Linear (for example, Planned → Completed), the related post in Featurebase is updated automatically and all upvoters are 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 of 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 → Linear
Then choose ‘Configure rules’
From the top left, choose the Linear team for which you want to map the statuses
Switch between Issue rules and Project rules at the top
Click New issue rule (or project rule) and configure:
The Featurebase status and corresponding Linear status (for every status)
Sync direction (explained below)
Applicable board (if the rule should only apply to a specific board)
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 a delay in the Linear issues getting a link back to Featurebase, as we have to wait to avoid rate limiting from 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. After this, when you change the status of your Linear project or create a new one, Featurebase will automatically create a post.
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 them in Featurebase to make them different from your internal ones.
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 or projects
Linking Featurebase posts to existing Linear issues or projects is essentially the same:
In Featurebase, simply open up the post
Click the Linear icon on the top right
Select ‘Link to existing issue or project’
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.