Asana Integration

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

Setup

Step 1: Connect Asana

1. Go to Project Settings > Integrations > Asana
2. Click Connect to Asana
3. Authorize SimpleCommenter in the popup
4. Grant access to your Asana account

Step 2: Choose a Workspace

After connecting, select which Asana workspace to use. The workspace selector appears above the routing mode toggle — it applies to both Simple and Advanced mode.

Step 3: Choose a Destination

Select where tasks should be created:

1. Project — pick which Asana project will receive tasks (required)
2. Section — optionally place tasks in a specific section like "To do" or "Backlog"

Step 4: Choose a Routing Mode

Simple Mode

All feedback goes to one project and section. Select 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 projects and sections based on conditions. For example, route design feedback to one project and bugs to another.

See Routing Rules below for the full list of options.

Step 5: 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 Asana in two places:

Project Settings

Go to Project > Settings > Integrations > Asana

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

Default Settings

Go to Default Settings > Integrations > Asana

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

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 Asana project and section.

Examples

• Client feedback to a dedicated project: Condition = "Commenter role is Client" → Project: Client Reviews / Section: Incoming
• Bugs to development: Condition = "Page URL contains /app" → Project: Development / Section: Backlog
• High priority alerts: Condition = "Priority is High or Urgent" → Project: Urgent / Section: To do

What Gets Synced

New Feedback → Asana Task

When someone submits feedback, a task is created with:

Task name:

#123 | Button not working on checkout page

Task description includes:

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

Attachments:

• Screenshot (uploaded to the task)
• Any files the user uploaded

Priority (custom field):

If your Asana project has a "Priority" custom field, it's set automatically:

Status (custom field):

If your Asana project has a "Status" custom field, new tasks are set to On track by default.

Replies → Task Comments

When you reply to feedback in SimpleCommenter, a comment (story) is added to the Asana task with the reply text and any attachment links.

Status & Priority Updates

When you change status or priority in SimpleCommenter:

1. The task's priority custom field is updated (if mapped)
2. If status changes to Done or Cancelled, the task is marked complete in Asana
3. If status changes back from Done/Cancelled, the task is marked incomplete
4. 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 workspace, project, section, and routing rules are preserved.

• Enabled: Feedback syncs to Asana 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 Asana shows as connected
3. Verify workspace and project — A workspace and project must be selected
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 the token

Priority or Status Not Showing?

Asana uses custom fields for priority and status. SimpleCommenter auto-detects fields named "Priority" and "Status" with enum options. Make sure:

• Your Asana project has these custom fields added
• The fields are enum type (dropdown)
• Priority options include "Low", "Medium", and "High"
• Status options include "On track"

Token Expired?

Asana access tokens expire after about an hour. SimpleCommenter automatically refreshes them using the refresh token. If you see authorization errors, try disconnecting and reconnecting.

Disconnecting

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

Next Steps

• Connect Monday.com for board-based tracking
• Set up Slack notifications
• Configure webhooks for custom workflows