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
Log in to Marker.io and click Create a Project.
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.
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:
Go to your website.
Refresh the page.
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:
Make sure you’re logged into Linear.
Open Linear in a new tab to avoid any login issues.
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?
Go to Profile > Account Settings and disconnect your current Linear account.
Log into the new workspace in Linear.
Back in Marker.io, create a new project and choose Linear.
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:
Create Label Groups in Linear: Examples include:
Departments: Support, Dev Team, Marketing
Issue Type: Bug, Feature Request, Improvement
Show Labels in Marker.io: Add the Labels field to your Marker.io forms.
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.