Articles on: Integrations

Feedbucket and Linear integration

Feedbucket can deeply integrate with Linear. That means that your team should be able to manage all feedback inside of Linear instead of in the Feedbucket Admin.


Video Tutorial




Install the Linear integration on your Feedbucket project


  1. Go to your project and then click the tab Integrations.
  2. On the integrations page click the button Connect next to Linear as show in the image below.


  1. If this is the first time you are connecting Feedbucket and Linear, a pop-up will appear where you have to allow the connection between Feedbucket and Linear. Select your team and click on the Authorize button.


Admin scope is now required in order to create webhooks. If you don't allow the admin scope, Feedbucket can not add webhooks to complete the 2-way sync.


  1. You will now see a green bar on the Linear integration that indicates that the connection is made. The settings should have opened automatically but in case it doesn't, click on the Settings button to start configuring the Linear connection for this project.



Configure the Linear integration to your needs


Most often, you will create one Feedbucket project per client website you are building. That way you can connect each project to a specific project inside of Linear as well. It's up to you how you want to configure it.


After you connect you should see the configuration pop-up. If you don't, just click on the Open Settings button.


  1. Select the Team. If you only allowed one Team when connecting Feedbucket there should only be one value here.
  2. Select the project. You can search in the textfield for your project to more easily find it.


If you set the project as "No project (Team level)", Feedbucket will create new issues under your team. If you instead select a project, the issue will be created as part of that project.


  1. Select what state Feedbucket should create new issues in. Basically, this means that when Feedbucket creates a new issue in Linear, it will have this state.
  2. The resolve state is probably the only thing that might be a bit confusing. This is the state that Feedbucket should associate with a feedback being resolved. If feedback is resolved in Feedbucket, we will change the issue to this state. If an issue is moved to this state inside of Linear, we will resolve the feedback in Feedbucket.
  3. Optionally, you can select labels that the issue will be created with.
  4. Click on Advanced Settings top open up more settings.
  5. Configure Feedbucket to set a Milestone on each issue it creates. You need to select a project before Milestones becomes available.




How to use the Linear integration


Once you have configured everything as you wish, below is how the integration should behave.


When new feedback is created


Whenever a new piece of feedback is created in Feedbucket, an issue will be created inside of Linear. This issue will be placed in the project that you selected in step #2 above and have the state that you selected in step #3 above. The issue will automatically have all of the technical details that Feedbucket collected like the session information of the reporter, the screenshot/recording etc.


If you have selected any Labels in #5 or Milestone in #7 it will also automatically be set on the newly created issue in Linear.


Note that the issue will be created with the Linear account that you connected Feedbucket and Linear with in step #3 during installation.



When a new comment is created on feedback


A piece of feedback can have lots of comments as a thread to communicate and collaborate. When a new comment is created on a piece of feedback that has been created in Linear by Feedbucket, that comment will also be created inside of Linear under the correct issue. That way, all comments that happens in Feedbucket will automatically be pushed to Linear as well.


Comments created in Feedbucket is automatically pushed to Linear as well.



When the feedback is resolved


If the feedback gets resolved from Feedbucket, the issue will change state to what you configured in step #4.


Again, there is a 2-way integration here as well. If the issue is moved to the state selected in #4 in the configuration, it will resolve the feedback in Feedbucket.


If the issue in Linear is moved to any state that is of type Canceled, we will also resolve it in Feedbucket (for example Duplicate or Canceled).



When the feedback is re-opened


If the feedback gets re-opened from Feedbucket the issue will change state to the Open state that you configured in step #3.


There's a 2-way sync here as well. If you change the issue from the state in step #4 to something else, it will be unresolved again in Feedbucket.



FAQ


What permissions are required to integrate with Linear?

Admin permissions are required to the Linear project that you want to connect with.


Why do I need Admin scope to connect with Feedbucket?

To be able to create webhooks we need the admin scope. If we can't create webhooks we can not act on changes happening inside of Linear. Therefore, without webhooks the 2-way sync can't work.



How to disconnect the Linear integration


When the Linear integration is active you will see a button for Disconnect. Click this to disconnect your Linear integration with this project.



Updated on: 12/01/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!