ClickUp Integration

Turn feedback into ClickUp tasks. When someone submits feedback, a task is created in your chosen list with the message, screenshots, priority, and a link back to your site.

Setup

Step 1: Connect ClickUp

1. Go to Project Settings > Integrations > ClickUp
2. Click Connect to ClickUp
3. Authorize SimpleCommenter in the popup
4. Select the workspace(s) to grant access to

Step 2: Choose a Destination

After connecting, select where tasks should be created:

1. Workspace — pick your ClickUp workspace
2. Space — choose a space within the workspace
3. Folder — select a folder, or choose "Folderless" for lists outside folders
4. List — pick the list where tasks will land

Step 3: Choose a Routing Mode

Simple Mode

All feedback goes to one list. Select your workspace, space, folder, and list from the dropdowns.

Good for small teams or projects where all feedback goes to the same place.

Advanced Mode

Create routing rules that send feedback to different lists based on conditions. For example, route high-priority feedback to an "Urgent" list or client feedback to a separate list.

See Routing Rules below for the full list of options.

Step 4: Enable the Integration

Use the toggle in the header to turn the integration on. You can disable it at any time to pause syncing without disconnecting or losing your settings.

Where to Configure

You can set up ClickUp in two places:

Project Settings

Go to Project > Settings > Integrations > ClickUp

• Applies only to this specific project
• Overrides any default settings

Default Settings

Go to Default Settings > Integrations > ClickUp

• Applies to all new projects automatically
• Useful if you want every project to create tasks in the same list

Routing Rules

In Advanced mode, each rule has four parts:

Triggers

Choose which events fire the rule:

| Trigger | When it fires | |---------|---------------| | New comment | Someone submits feedback | | Reply | Someone replies to existing feedback | | Status update | A comment's status or priority changes |

New rules default to New comment and Reply enabled.

Conditions

Filter which feedback matches the rule. No conditions means the rule matches everything. Multiple conditions use AND logic — all must match.

| Field | Operators | Values | |-------|-----------|--------| | Priority | is, is not | Low, Normal, High, Urgent | | Status | is, is not | To Do, In Progress, Review, Rework, On Hold, Blocked, Done, Cancelled, Won't Fix | | Commenter role | is, is not | Client, Team Lead, Workspace Admin | | Tagged user | includes | Any team member | | Page URL | is, contains, starts with | Text (e.g. /blog, /pricing) |

Destination

Each rule sends matching feedback to a specific ClickUp list.

Examples

• Client feedback to a dedicated list: Condition = "Commenter role is Client" → List: Client Feedback
• High priority to urgent list: Condition = "Priority is High or Urgent" → List: Urgent
• Blog feedback separate: Condition = "Page URL starts with /blog" → List: Content Feedback

What Gets Synced

New Feedback → ClickUp Task

When someone submits feedback, a task is created with:

Task title:

#123 | Button not working on checkout page

Task description includes:

• The feedback message
• Who submitted it (name, email)
• Date and time
• Page URL
• Status and priority
• Link back to SimpleCommenter

Attachments:

• Screenshot (if captured)
• Any files the user uploaded

Priority:

ClickUp's built-in priority field is set automatically:

Tags:

Each task is tagged with simplecommenter for easy filtering.

Replies → Task Comments

When you reply to feedback in SimpleCommenter, a comment is added to the ClickUp task with the reply text. Any attachments are uploaded to the task.

Status & Priority Updates

When you change status or priority in SimpleCommenter:

1. The task's priority field is updated in ClickUp
2. The task's status is updated to match (mapped to your list's status names)
3. A comment is added to the task describing the change

Enabling and Disabling

The toggle in the integration header lets you pause syncing without disconnecting. Your list selection and routing rules are preserved.

• Enabled: Feedback syncs to ClickUp as configured
• Disabled: No tasks are created or updated. Settings stay intact

Troubleshooting

Tasks Not Creating?

1. Check the toggle — Make sure the integration is enabled (not just connected)
2. Check authorization — Verify ClickUp shows as connected
3. Verify list selection — The selected workspace, space, and list must still exist in ClickUp
4. Check routing rules — In Advanced mode, at least one rule must be active with matching conditions
5. Re-authorize — Click Disconnect, then Connect again to refresh

Status Not Updating on Tasks?

ClickUp requires the status name to match exactly. If your list uses custom status names (e.g., "Todo" instead of "to do"), the PUT update may not apply. The change will still be recorded as a task comment.

Disconnecting

1. Go to Integrations > ClickUp
2. Click Disconnect
3. Confirm the disconnection

Next Steps

• Connect GitHub for issue tracking
• Set up Slack notifications
• Configure webhooks for custom workflows