Easily track website issues directly within Trello by integrating Marker.io. This guide walks you through the setup process, from connecting your Trello account to reporting and managing issues.
Set up a Trello integration
Add a project
Log in to your Marker.io dashboard.
Click Create a project.
Fill out the form:
Project name
Website URL where you'll collect issues
Integration: select Trello
Trello board: choose where issues should be sent
If this is your first time connecting, you need to authorize Marker.io to use your Trello account.
Configure forms
Marker.io automatically pulls in your Trello fields, such as labels, due dates, and priorities. You can customize which fields are visible. For example, set a default label of "Dev Team" so issues are immediately routed to your developers.
Note: Marker.io has two types of forms: the Member form, used by team members, and the Guest form, used by external users and public reporters. More on that in our User Roles: Admins, Managers, Members, Guests & Reporters guide.
Manage project access
Separately from your Trello 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 Trello project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying Trello 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
Website visitors can report issues directly through the Marker.io widget without leaving the page they're on. Each report automatically includes technical details:
Page URL
Browser
Screen size
Operating system
For example, if a visitor notices the "Contact Us" button is broken, they can click the widget, take a screenshot, and submit the issue with relevant details. Screenshots can be annotated, and the form can be customized as needed. We recommend keeping it simple for non-technical reporters.
Review issues
Once submitted, an issue automatically appears in your Trello project with the screenshot, technical data, and any comments or labels set according to your preferences. You can then assign, prioritize, and track the issue within Trello.
Communicate with reporters
Each Trello card created via Marker.io includes a link back to the Feedback Page, letting you communicate directly with the reporter. Replies you send from the Feedback Page are automatically synced to Trello as comments. Comments made directly on the Trello card don't sync back to Marker.io the same way. Reply from the Feedback Page if you need the reporter to see it.
Synchronize status
When an issue's status is updated to "Done" in Trello, Marker.io marks the issue as Resolved and emails the reporter to confirm it's complete.
Permissions & troubleshooting
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.
What permissions are required to integrate with Trello?
Admin permissions are required so all boards, cards, and custom fields sync properly, including real-time status sync, accurate mapping of issues to boards and cards, and access to newly created boards. Marker.io doesn't store or share any of your Trello data beyond what's needed for the integration.
We recommend creating a dedicated Marker.io Bot user in Trello 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 Trello
If your issues have suddenly stopped syncing, there are two common causes to check.
1. Reconnect your Trello account. A change to your Trello account credentials, like an updated password, can disrupt the connection.
Go to your Marker.io project's Settings > Integration.
Click Resync account to re-establish the connection.
Submit a test issue to check it appears in Trello.
2. Check if your Trello board is set to read-only. This can happen if you've exceeded the limits of your Trello plan (users, storage, or other plan-specific constraints).
Log in to Trello and verify whether you've reached your plan's limits.
Upgrade your Trello plan if needed.
Common signs of a read-only board: you can view issues but can't edit or add new ones, or Trello shows an alert that you've exceeded your plan's limits.
I can't connect my Trello account to Marker.io
Try the following, in order:
Log in to Trello in a second tab. This ensures your username and password don't trigger extra security verification. Once logged in, return to Marker.io and try connecting again.
Reset your Trello password, then attempt to reconnect.
Still stuck? Start a chat with us using the icon in the lower right corner.
How do I add custom fields in Marker.io via the Trello integration?
Make sure you're on a Trello paid plan that supports custom fields, then add the custom fields within Trello.
In Marker.io, go to the relevant project > Widget > Guest forms (or Member forms) > drag the custom field into the "Drop fields here to make them visible" zone.
Using more than one Trello account
If you manage multiple Trello accounts, see [[Managing Multiple Integrated Accounts]] for how to set this up cleanly without accounts overwriting each other.
Invite your team to collaborate on a dedicated Trello board today with Marker.io, where anyone can report bugs and feedback in seconds. See [[Get started with Marker.io]] for more on getting the most out of your setup.
Need Help?
If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.