Collect website feedback as new issues directly in your Asana projects. Issue status and fields stay in sync automatically. See the note on comment sync below for how communication works.

To get started, go to the Marker.io dashboard and click Create project.

In the Create new project window, enter:

Next, under Integration, select Asana (or click + Add integration if this is your first time connecting; you'll be asked to authorize Marker.io to use your Asana account). Once selected, three additional fields appear:

Click Show more to reveal the Project Key field: used to generate your Marker.io issue IDs (e.g. PROJ-1, PROJ-2). Set this before creating the project. It's harder to change cleanly afterward.

Once everything's filled in, click Create project.

Marker.io has two separate forms, each pulling in your native Asana fields. Go to your project's Widget settings to configure them.

Guest forms (for Guests and Public Reporters, anyone reporting without logging in) show only the Bug issue type by default. Fields are drag-and-drop: drop a field into the "Drop fields here to make them visible" zone to expose it on the form. Anything not dragged up stays under Hidden Fields: by default that includes Title, Section, Parent task, and Assignee.

Member forms (for logged-in Members and Admins; best for QA and internal reporting) default to both Improvement and Bug issue types enabled, and expose more fields out of the box (Section, Assignee, Tags, Due date) without needing to drag them up first.

For example, preset the Section field to To Do so all new feedback lands directly in your To Do section rather than needing to be triaged manually.

Separately from your Asana 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:

Admins always have access regardless of this setting. This is a Marker.io-side permission, distinct from the Asana project access covered in Permissions & Troubleshooting below. Someone can have full access to feedback inside Marker.io without necessarily having access to the underlying Asana project, and vice versa. Worth keeping both in mind if a teammate says they "can't see" something.

Go to your project's Widget > Installation and choose how to install.

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.

Once connected, fine-tune the Asana integration under Settings > Integration.

Status auto-update: toggle on to keep Marker.io's status in sync with Asana automatically:

Activity updates: two independent toggles that auto-post a comment on the Asana task when the issue status changes, and when the issue type changes. These are system-generated comments, separate from manual replies (see the note on comment sync in Permissions & Troubleshooting below).

Main account: the Asana account used for general operations and reporting. Shows as Resync account / Connect a new team account here if it ever needs re-authorizing.

Reporting account: controls which Asana account members report through:

Guests always report through the main project account regardless of this setting. There's no personal-account option for guests.

Remove integration: permanently disconnects Asana from this project. This is different from resyncing. There's no undo, so double-check before using it.

Reporters can submit their feedback directly to your Asana project without leaving their website. Their feedback automatically includes detail-rich technical data.

Let's say the Contact Us button is broken on the About Us page. The reporter clicks on the widget and is presented with a screenshot and a feedback form to complete. The screenshot can be annotated, and the feedback form can be as simple or as complex as you wish. We recommend keeping it simple for non-technical reporters.

The form includes an Issue type picker (e.g. Improvement, Bug) and, if the reporter has access to more than one project, a project switcher to choose the right destination before submitting. Depending on what's exposed in Guest/Member forms (see Configure forms above), fields like Section, Assignee, Tags, and Due date can also appear, each with a small refresh icon to reset to its synced default.

In your Asana project, feedback arrives with the screenshot and automatically captured technical data, including:

The "Contact via Marker.io" link opens the Feedback Page: reply there to reach the reporter. Marker.io auto-posts a system comment to the Asana task when issue status or type changes (see Integration settings above), but replies typed directly in Asana won't reach the reporter. Always use the Feedback Page for two-way communication with them.

With Status auto-update turned on (see Integration settings above), marking a task Complete in Asana updates the Marker.io status to Resolved and notifies the reporter via email that the issue is complete. Marking it Incomplete or deleting it maps to Open/In Progress or Closed, respectively.

Admin permissions are required on the Asana 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 for that project. This is the most common cause of "issues stopped syncing" reports.

We recommend creating a dedicated Marker.io Bot user in Asana 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]].

Note: if your Reporting account is set to Personal Asana account (see Integration settings above), this applies per-member. Each person's own Asana access matters, not just the main account's. If a specific member's issues stop syncing while others' still work, check their individual Asana project access first before assuming the main connection is broken.

If issues have stopped appearing in your Asana project:

If tickets are created but status sync or comments aren't coming through:

Try the following, in order:

If you manage multiple Asana workspaces or accounts, see [[Managing Multiple Integrated Accounts]] for how to set this up cleanly without accounts overwriting each other.

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 Asana 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.

If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.