Welcome to the Linear integration guide.
I'm going to walk you through all the steps of setting up the integration in just a couple of minutes.
Step 1. Connect your linear account
Go to Dashboard -> Settings -> Integrations and click on 'Connect to Linear'.
Next click on Authorize Featurebase from Linear. It should redirect you back to the dashboard after that. If the Linear button says 'Configure Linear', you have successfully connected Featurebase with Linear.
Step 2. Configure Linear
Once connected, click on the Configure Linear button.
There are a couple of important settings to configure.
Select a default team.
Choose what happens when you delete a linked linear issue.
Creating rules
Rules are used for syncing statuses between Featurebase and Linear. 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.
Go to Dashboard -> Settings -> Integrations and click on Configure Linear.
Start by clicking on Create Rule in the bottom right.
You will now have to choose a Featurebase status and a Linear status to sync with each other. After selecting both of those, you can also select the sync direction.
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.
After selecting the direction, select whether to notify users when you change a status in Linear. If set to Notify, all upvoters will receive an email if you change a status in Linear.
You can automatically push new feedback to Linear by creating a rule between Featurebase's "In Review" and your Linear initial status e.g. "Backlog" or "Triage".
We recommend creating a rule for every Featurebase status you actively use.
Example of a rule:
Push unsynced Featurebase post to Linear
You can send any Featurebase post to linear in just a couple of clicks!
Go to a post you wish to send to Linear and click the Linear logo on the top right and select "Create new issue".
Modify the title/content to your liking and press the Push to Linear button to send it there.
Link existing Linear issues with a Featurebase post
Any existing Linear issue can be linked to a Featurebase post very easily.
Go to the post you wish to link with the Linear issue, click the Linear button in the top right, then select "Link to existing issue".
Search for the Linear issue using the search bar and click Link to Issue.
