This guide walks you through setting up the Marker.io integration with ClickUp, allowing you to collect website issues directly in your ClickUp projects. Issue status and fields stay in sync automatically. See the note on comment sync below for how communication works.
Set up a ClickUp integration
Add a project
Go to your Marker.io dashboard and click Create project.
Fill in the project details:
Project name: how it appears in your Marker.io workspace
Website URL: the site you want to collect feedback and run checks on
Integration: select ClickUp
Space selection: choose the ClickUp space where new issues will be sent
Note: the first time you connect, you'll need to authorize Marker.io to access your ClickUp account. If you manage multiple ClickUp workspaces or accounts, see Managing Multiple Integrated Accounts to avoid accounts overwriting each other.
Configure forms
Marker.io automatically fetches your ClickUp fields into your widget form. You can:
Show/hide fields
Set default field values (e.g. default Priority to "High" but let reporters adjust it)
Marker.io uses two forms:
Member form: for registered Marker.io members
Guest form: for public reporters and guests
More on that in our [[User Roles: Admins, Managers, Members, Guests & Reporters]] guide.
Manage project access
Separately from your ClickUp 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 ClickUp project access covered in Permissions & troubleshooting below: someone can have full access in Marker.io without access to the underlying ClickUp project, or the other way around.
Install widget
Install the Marker.io widget on your website to start collecting issues. Options include:
Recommended: manual JavaScript installation
WordPress plugin
NPM package
Send an installation request to your developer with one click
Once installed, visit your website and refresh the page to confirm the widget is visible.
How it works
Collect feedback
Visitors can report issues directly through the Marker.io widget on your website. Each submission automatically includes a screenshot and detailed technical data, such as:
Page URL
Browser type
Screen resolution
Operating system
Example: if the "Contact Us" button on the "About Us" page isn't working, the visitor can click on the widget, annotate the screenshot, and provide additional details.
Review issues
All reported issues appear in your selected ClickUp space with the associated screenshot and technical data. You can review, prioritize, and update these issues directly in ClickUp.
Communicate with reporters
Use the "Contact via Marker.io" link on your ClickUp task to open the Feedback Page, where you can reply to the reporter. Marker.io pushes your replies into ClickUp as comments, but comments made directly in ClickUp don't sync back to Marker.io. The integration is one-way, from Marker.io to ClickUp, for comments. Always reply from the Feedback Page if you need the reporter to see it.
Want two-way comment sync? It's a tracked feature request: Two-way sync of comments. Upvoting and adding your use case helps the team prioritize it.
Synchronize status
When you mark an issue Complete in ClickUp, Marker.io automatically updates the status to Resolved and sends an email notification to the reporter.
Permissions & troubleshooting
What permissions are required to integrate with ClickUp?
You need admin permissions on the ClickUp space or project you're integrating with Marker.io. If the connected account is later removed, 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 ClickUp 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 ClickUp
If issues have stopped appearing in your ClickUp project, this is usually a connection or access problem rather than something wrong with a specific issue:
Check that the ClickUp account connected to Marker.io still has access to the target space or 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 to re-establish the connection.
Submit a test issue and confirm it appears in ClickUp.
If issues still fail to create after checking the above, particularly if ClickUp shows an error mentioning a required field, check whether a required field on your ClickUp list (a dropdown or custom field) has a value Marker.io isn't sending. Contact support with the specific error if you're unsure. This is uncommon enough to be worth a second pair of eyes rather than guessing.
Check for ClickUp plan or permission restrictions
Sometimes syncing breaks because your ClickUp space or project has become restricted, often after a plan change or permissions update:
Verify plan limits: log in to ClickUp and check whether your current plan restricts user roles, storage, or access levels.
Check permissions: confirm the connected space or project still allows Marker.io to create and update issues.
Upgrade if needed: if you've hit a plan restriction, upgrade to a higher-tier ClickUp plan.
Common signs of this: you can view issues in ClickUp but can't add or edit new ones, or ClickUp shows a notification that plan limits affecting collaboration have been reached.
I can't connect my ClickUp account to Marker.io
Try the following, in order:
Log in to ClickUp in a separate tab first. This avoids extra security verification prompts. Then return to Marker.io and try connecting again.
Reset your ClickUp password and retry.
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 ClickUp integration?
Add custom fields in ClickUp. See ClickUp'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 ClickUp account
If you manage multiple ClickUp workspaces or accounts, see [[Managing Multiple Integrated Accounts]] for how to set this up cleanly.
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 ClickUp space 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.