Skip to main content
Linear Integration

Linking Marker.io with Linear for Issue Tracking

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

Integrating Marker.io with Linear lets you capture website issues directly into your Linear projects. This guide will walk you through how to set everything up, customize forms, and get your widget live on your website in just a few steps.


Set up a Linear Integration

Create a New Project

  1. Log in to Marker.io and click Create a Project.

  2. Fill out the project details:

    • Project Name: Pick a name that helps identify the project.

    • Website URL: Add the URL of the website where issues will be reported.

    • Select Integration: Choose Linear.

    • Select a Space: Pick the space within Linear where you want the issues to show up.

  3. Authorize the Connection: If it’s your first time linking Marker.io to Linear, you’ll need to give access.

Customize Your Forms

You can adjust the fields in your Marker.io widget form to match your Linear setup:

  • Choose Which Fields to Show: Decide what info is important.

  • Preset Fields: For example, set the default label as “Dev Team” to make sure the right people see the issue.

Tip: Marker.io members use the Member form, while Guests and Public Reporters use the Guest form. For more on this, check out our User Roles Guide.

Install the Widget

There are a few ways to add the Marker.io widget to your website:

  • JavaScript (Manual Install): This is the most common method.

  • WordPress Plugin

  • NPM Package

  • Send Install Request: You can send a request to your developer straight from Marker.io.

Once the widget is installed:

  1. Go to your website.

  2. Refresh the page.

  3. Confirm the widget is visible.


How it works

Reporting Issues

Let’s say a button isn’t working on your website. The reporter can click the Marker.io widget, which automatically takes a screenshot. They can then fill out a simple form and submit it.

The report automatically includes helpful data like:

  • The page URL

  • Browser details

  • Screen size

  • Operating system

Reviewing Issues in Linear

In your Linear project, the issues will appear with all the captured details, making it easy to understand, reproduce and fix.

Communicating with Reporters

You can stay in touch with reporters directly through Marker.io:

  • Use the "Contact via Marker.io" link to open a dedicated issue page and chat with them.

  • Everything syncs between Marker.io and Linear, so you won’t miss a thing.

Synchronize Status

When you mark an issue as “done” in Linear, Marker.io automatically updates the status and sends an email to let the reporter know the issue is resolved.


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?

You’ll need admin access for the Linear project you want to link.


Why Can’t I Connect My Linear Account?

If you’re having trouble, try this:

  1. Make sure you’re logged into Linear.

  2. Open Linear in a new tab to avoid any login issues.

  3. If it still doesn’t work, try resetting your password.

Still stuck? You can reach out to us through the chat in Marker.io.


How Do I Add Another Linear Workspace?

  1. Go to Profile > Account Settings and disconnect your current Linear account.

  2. Log into the new workspace in Linear.

  3. Back in Marker.io, create a new project and choose Linear.

  4. Connect and authorize the new workspace.


Can I Add Custom Fields in Marker.io for Linear?

Linear doesn’t offer traditional custom fields, but you can use labels to organize your reports. Here’s how:

  1. Create Label Groups in Linear: Examples include:

    • Departments: Support, Dev Team, Marketing

    • Issue Type: Bug, Feature Request, Improvement

  2. Show Labels in Marker.io: Add the Labels field to your Marker.io forms.

  3. Use Labels for Reporting: Reporters can select multiple labels to categorize their issues better.

Labels aren’t exactly the same as custom fields, but they provide a flexible way to organize and filter issues.


Need Help?

If you have any questions, comments, or corrections, chat with us at the bottom right of our web page.

Did this answer your question?