Collect website feedback as new issues directly in your Teamwork projects. Issue status and fields stay in sync automatically. See the note on comment sync below for how communication works.
Set up a Teamwork 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 Teamwork
Space: the space within Teamwork where you wish to receive feedback
If this is your first time connecting, you need to authorize Marker.io to use your Teamwork account.
Configure forms
Marker.io fetches your native Teamwork fields into your widget form. You can show/hide fields and preset values. For example, set a default Task list so feedback always lands in the right place.
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 Teamwork 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 Teamwork project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying Teamwork 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 Teamwork 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 Teamwork project, feedback arrives with the screenshot and automatically captured technical data, including:
Page URL
Browser
Screen size
Operating system
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 Teamwork as comments, but comments made directly in Teamwork don't sync back to Marker.io. This integration follows the same one-way (from Marker.io to Teamwork) comment pattern as our other integrations. Always reply from the Feedback Page if you need the reporter to see it.
đźď¸ [IMAGE PLACEHOLDER: side-by-side of replying in the Marker.io Feedback Page vs. replying inside Teamwork, showing which one notifies the reporter]
Synchronize status
Once you update an issue status to "Done" in Teamwork, 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 Teamwork?
Admin permissions are required on the Teamwork 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 Teamwork 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 Teamwork
If issues have stopped appearing in your Teamwork project:
Check that the Teamwork 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 tasks.
Go to your Marker.io project's Settings > Integration and click Resync account.
Submit a test issue and confirm it appears in Teamwork.
I can't connect my Teamwork account to Marker.io
Try the following, in order:
Log in to Teamwork 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 Teamwork 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 Teamwork integration?
Add custom fields in Teamwork. You need a paid Teamwork plan to enable custom fields. See Teamwork's Custom Fields guide for details.
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 Teamwork account
If you manage multiple Teamwork 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 Teamwork 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.