Effortlessly send bug reports and gather user feedback from Marker.io straight into your Basecamp to-do lists. This guide walks you through the integration process.
Set up a Basecamp integration
Add a project
To get started, go to the Marker.io dashboard and create a project. Complete the project form:
Project name
Website URL: the site where you wish to collect feedback
Integration: select Basecamp
Space: the space within Basecamp where you wish to receive feedback
If this is your first time connecting, you need to authorize Marker.io to use your Basecamp account.
Note: you need an active to-do list in your Basecamp project for issues to sync. If there isn't one yet, Marker.io will prompt you to add one before you can finish setup.
Configure forms
Marker.io fetches your native Basecamp fields into your widget form. You can show/hide fields and preset values. For example, set a default to-do list or assign feedback to a specific person automatically.
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: Admins, Managers, Members, Guests & Reporters]] guide.
Manage project access
Separately from your Basecamp 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 Basecamp project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying Basecamp project, or the other way around.
Install 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
Reporters can submit feedback directly to your Basecamp project without leaving their website. Their feedback automatically includes detail-rich technical data.
Say the Contact Us button is broken on the About Us page. The reporter clicks the widget and is presented with a screenshot and a feedback form to complete. The screenshot can be annotated, and the form can be as simple or as complex as you wish. We recommend keeping it simple for non-technical reporters.
Review issues
In your Basecamp project, feedback arrives with the screenshot and automatically captured technical data, including:
Page URL
Browser
Screen size
Operating system
As well as links to:
Console logs
Network requests
Session replay video
Communicate with reporters
The "Contact via Marker.io" link opens the Feedback Page, where you can reply to the reporter. Marker.io pushes your replies into Basecamp as comments, but comments made directly in Basecamp don't sync back to Marker.io. This integration follows the same one-way (from Marker.io to Basecamp) comment pattern as our other integrations. Always reply from the Feedback Page if you need the reporter to see it.
Synchronize status
Once you mark an issue as Completed in Basecamp, 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 Basecamp?
Admin permissions are required on the Basecamp project you wish to connect with. 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 Basecamp 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 Basecamp
If issues have stopped appearing in your Basecamp project:
Check that the Basecamp account connected to Marker.io still has access to the target project.
Confirm the account's role hasn't been downgraded below what's needed to create/update to-dos.
If you've recently changed the main Basecamp account connected to Marker.io, go to your Marker.io project's Settings > Integration, scroll to the bottom, and click Remove integration, then add it back with the correct account rather than just resyncing.
Otherwise, click Resync account under Settings > Integration.
Submit a test issue and confirm it appears in Basecamp.
Still not syncing after that? Start a chat with us using the icon in the lower right corner. This scenario can have a few different causes, so it's worth having our team take a look directly rather than guessing further.
I can't connect my Basecamp account to Marker.io
Try the following, in order:
Log in to Basecamp 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 Basecamp password, then attempt to reconnect.
Still stuck? Start a chat with us using the icon in the lower right corner.
Using more than one Basecamp account
If you manage multiple Basecamp accounts, see [[Managing Multiple Integrated Accounts]] for how to set this up cleanly without accounts overwriting each other.
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.
Invite your team to collaborate on a dedicated Basecamp project 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.