Linear Integration

Efficient website feedback with Linear in a few simple steps.

Joe Scanlon avatar
Written by Joe Scanlon
Updated over a week ago

Collect website feedback as new issues directly in your Linear projects. With our 2-way synchronization, your issue status, fields, and comments are always in sync.


Set up a Linear Integration

Add a project

To get started, go to the Marker.io dashboard and Create a project.

Complete the project form by entering a :

  • Project name

  • The website where you wish to collect feedback

  • Select your integration

  • Select the space within your integration where you wish to receive your feedback

If this is your first time connecting, you must authorize marker.io to use your Linear account.

Configure forms

We fetch your native Linear fields into your widget form. You can show/hide any fields and preset fields. For example, set the default label as "Dev Team" to ensure your development team is aware of all new feedback.

Note: Marker.io members report through the Member form, while Guests and Public Reporters report via the Guest form. More on that in our User Roles Guide.

Install widget

The last step is to install the website widget. We have many options for installing our widget and recommend our manual JavaScript install in most cases.

Alternatively, install the widget via WordPress plugin, NPM package, or send a request to your developer in one click.

Visit your website, refresh and check that the widget appears.


How it works

Collect feedback

Reporters can submit their feedback directly to your Linear project without leaving their website. Their feedback will automatically include detail-rich technical data.

Let’s say the Contact Us button is broken on the About Us page. The reporter clicks on the widget and is presented with a screenshot and a feedback form to complete.

The screenshot can be annotated, and the feedback form can be as simple or as complex as you wish. We recommend keeping the feedback form as simple as possible for your non-technical reporters.

Review issues

In your Linear project, you see the feedback arrive with the screenshot and automatically captured technical data, including:

  • Page URL

  • Browser

  • Screen size

  • Operating system

Communicate with reporters

The "Contact via Marker.io" link opens the Feedback Page, where you can communicate with your reporters. All conversations will be synced with Linear.

Synchronize Status

Once you update an issue status to “done” within Linear, this will update the Marker.io status to resolved and notify the reporter via email that the issue is complete.


FAQs


Is Marker.io secure?

We take your data and the security of our systems very seriously, using the most advanced security to connect with your account. See the latest version of our security policy at: https://marker.io/security.


What permissions are required to integrate with Linear?

Admin permissions are required on the Linear project you wish to connect with.


I can't connect my Linear account to Marker.io

Any issues setting this up? Try the following:

  1. Log in to your Linear account

    Log in to Linear in a second tab. This ensures that your password and username do not require additional security verification. When logged in to Linear, return to Marker.io and try connecting your Linear account.

  2. Reset your password in Linear

    Try setting a new password in your Linear account and see if that helps to resolve the issue.

  3. Still not working?

    Please start a chat conversation with us in the lower right corner of your screen.


How do I connect to a second Linear workspace?

At times you may like to add a second Linear workspace to your Marker.io account.

  1. Navigate to your Profile -> Accounts settings and disconnect your current Linear account.

  2. Log into Linear.app on a new tab within the same browser session.

  3. Ensure that the new workspace you wish to add is selected on Linear.

  4. Back at Marker.io add a new project and select Linear.

  5. Connect Linear account.

  6. Authorize your new Workspace.

  7. This new project can now be used to report website feedback.


How do I add custom fields in Marker.io via the Linear Integration?

Linear app custom fields

While Linear doesn't allow you to create traditional custom fields, you can utilize labels to achieve similar functionality. This can be particularly useful if you want to allow reporters to select specific attributes like their Department or Feedback Type during reporting.

Step 1: Define Label Choices in Linear

Create choices within Linear for each label type you want to use. We recommend organizing these into separate groups for clarity. For example:

Department

  • Customer Support

  • Dev Team

  • Marketing

Feedback

  • Bug

  • Feature

  • Improvement

Step 2. Present the Labels field on your Marker.io forms.

In Marker.io, you must present the Labels field on your forms. This will allow the labels you've created in Linear to be selectable within Marker.io.

Step 3: Reporting with Labels

When reporters provide feedback, they'll see the Labels field. They can select as many labels as necessary to describe their feedback accurately. This makes the reporting process more flexible and tailored to your specific needs.

While labels in Linear don't function exactly like custom fields, they offer a versatile way to categorize and filter issues. By following the above steps, you can create a more dynamic and customized reporting process using labels in Linear.


Invite your team to collaborate on a dedicated Linear project today with Marker.io, where anyone can report bugs and feedback in seconds. We have many advanced features for you to explore. See Marker.io Academy, which we continuously update with our latest features.

Did this answer your question?