Integrating Marker.io with Linear lets you capture website issues directly into your Linear projects. This guide walks you through setup, form customization, and getting your widget live in just a few steps.
Set up a Linear integration
Add a 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: the URL of the website where issues will be reported
Integration: select Linear
Space: pick the space within Linear where you want issues to show up
If it's your first time linking Marker.io to Linear, you'll need to authorize the connection.
If you manage multiple Linear workspaces, see [[Managing Multiple Integrated Accounts]] to avoid accounts overwriting each other.
Customize your forms
Adjust the fields in your Marker.io widget form to match your Linear setup:
Choose which fields to show
Preset fields: for example, set the default label to "Dev Team" so the right people see the issue
Tip: Marker.io members use the Member form, while Guests and Public Reporters use the Guest form. More on that in our [[User Roles: Admins, Managers, Members, Guests & Reporters]] guide.
Manage project access
Separately from your Linear connection, Marker.io controls who can see and manage feedback for this project via Manage access (top-right of the project's Widget or Feedback view).
Two ways to grant access:
Groups > Workspace members: toggle this on to give everyone in your Marker.io workspace access at once
People: invite individuals one at a time. Each can be removed independently. Guest-level users show a GUEST badge next to their name, distinguishing them from full members in the list.
Admins always have access regardless of this setting. This is separate from your Linear project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying Linear project, or the other way around.
Install the widget
Go to your project's Widget > Installation and choose how to install.
Tip: click Try on demo website first to test-drive the widget before installing anything on your real site.
Browser extension: quick setup, no code required. Each reporter installs the extension individually. You can also toggle "Inject widget on my website" per domain to show it automatically for extension users on that site.
Code snippet & CMS plugins: a one-time, site-wide install, accessible to all reporters. Sub-tabs cover Code snippet (paste into the
<HEAD>tag), NPM package, CMS plugins, and Send to developer (one-click handoff).
AI coding agent: point your AI coding agent at this and it picks the right install method (npm, snippet, or CMS plugin) and wires it up for you.
Visit your website, refresh, and check that the widget appears. If you used the browser extension method, remember: each reporter needs the extension installed in their own browser before they can see the widget. It won't appear for reporters who haven't installed it.
How it works
Collect feedback
Say a button isn't working on your website. The reporter clicks the Marker.io widget, which automatically takes a screenshot. They fill out a simple form and submit it.
The report automatically includes:
Page URL
Browser details
Screen size
Operating system
Review issues
Issues appear in your Linear project with all the captured details, making them easy to understand, reproduce, and fix.
Communicate with reporters
Use the "Contact via Marker.io" link to open the Feedback Page and reply to the reporter. Marker.io pushes your replies into Linear as comments, but comments made directly in Linear don't sync back to Marker.io. The integration is one-way (from Marker.io to Linear) for comments. Always reply from the Feedback Page if you need the reporter to see it.
Synchronize status
When you mark an issue "Done" in Linear, Marker.io automatically updates the status to Resolved and emails the reporter to let them know.
Permissions & troubleshooting
What permissions are required to integrate with Linear?
You'll need admin access to the Linear project you want to connect. If the connected account is later removed from the project, or its role is downgraded, sync will silently stop working. This is the most common cause of "issues stopped syncing" reports.
We recommend creating a dedicated Marker.io Bot user in Linear rather than connecting a personal account, so sync doesn't break when an individual leaves the team or changes roles. See [[Create a Service Account or Dedicated User for your integration]].
Issues not syncing to Linear
If issues have stopped appearing in your Linear project:
Confirm the Linear account connected to Marker.io still has admin access to the target project.
Confirm the project is still active and hasn't been archived or restructured.
Go to your Marker.io project's Settings > Integration and click Resync account to re-establish the connection.
Submit a test issue and confirm it appears in Linear.
If it's still not working, note whether sending an issue manually produces an error message or just fails silently. That detail helps support narrow down the cause quickly.
Why can't I connect my Linear account?
Try the following, in order:
Make sure you're logged into Linear.
Open Linear in a new tab first. This avoids extra security verification prompts. Then return to Marker.io and try connecting again.
Still not working? Try resetting your Linear password and retry.
Still stuck? Start a chat with us using the icon in the lower right corner.
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:
Create label groups in Linear. Examples:
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.
Is Marker.io secure?
We take your data and the security of our systems seriously, using industry-standard security practices to connect with your account. See our latest security policy at marker.io/security.
Need Help?
If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.