---
title: Asana Integration for TestingBot
description: 'Connect Asana to TestingBot with one-click OAuth and report bugs from
  any test: create or update Asana tasks with test metadata, screenshots and a link
  back to the test.'
source_url:
  html: https://testingbot.com/support/integrations/asana-issue-tracker
  md: https://testingbot.com/support/integrations/asana-issue-tracker/index.md
---
# Asana Integration

Enable the Asana integration to report bugs straight from your tests: create a new Asana task or comment on an existing one, with test metadata, screenshots and a link back to the test included automatically.   
 A **Report a bug** button appears on every test detail page, and during a Live Testing session you can file an annotated screenshot as an Asana task.

## Connect Asana

Go to [Members \> Integrations](https://testingbot.com/members/integrations) and click **Asana** , then click **Connect with Asana**.

 ![Connect Asana to TestingBot](https://testingbot.com/assets/support/integrations/asana/asana1-3dd27b459a556c9d6a0d0c038e602ec71a3b5d441174d3736dfe23196be9def4.png)

You will be redirected to Asana to authorize TestingBot. We request access to create and update tasks on your behalf so we can file work items and add comments. We never see your password, and you can revoke access at any time from your Asana account settings.

Once connected, the page shows the Asana account TestingBot is connected as.

## Report a bug

Open any test from the Test Detail page. In the header you will find a **Report a bug** button. Once one or more tasks are linked to the test, the same button shows the number of linked tasks instead.

 ![Report a bug button with the Asana option](https://testingbot.com/assets/support/integrations/asana/asana2-14aa8d2a5dbd184e68eb877e7668576f60b12876fdf5e7526b52460d221ea408.png)

Click it and choose **Asana** from the menu.

This opens a dialog. Pick the `Workspace` and `Project` you want to file the task in, then fill in the `Title` and `Description`. The description is pre-filled with the test metadata.

 ![Create an Asana task from a TestingBot test](https://testingbot.com/assets/support/integrations/asana/asana3-c5ddd32b3d9dec0d09f75649fba073cbb63999d5adbf0571c82a1fe07fddb023.png)

You can optionally choose an `Assignee` from the workspace's members.

Click **Create task**. The task is created in your project and TestingBot shows a link to view it on Asana. The task is also linked to the test, so teammates opening the same test can see which tasks were already reported.

## Update an existing task

Already have a task for this bug? Switch to the **Update existing task** tab, select one of the project's open tasks from the `Task` dropdown and write a comment. The comment is pre-filled with the test metadata and is added to the task as a new comment on Asana.

Commenting on a task links it to the test as well, so the test's task counter includes tasks you commented on.

## What gets included

The pre-filled description (or comment) contains a metadata block with:

- The test name, linked to a shareable test page with the video, screenshots and logs
- The test result (passed or failed)
- The browser or device and operating system the test ran on
- The error message, when the test failed with one

You can edit or remove any of this before submitting. Whoever opens the task on Asana can follow the test link to watch the video and inspect the logs, without needing a TestingBot account.

## Live Testing

During a manual Live Testing session, click **Report Bug** to take a screenshot and annotate it in the editor. Then click **Report a bug** and choose **Asana**.

The same dialog appears; the annotated screenshot is uploaded to the task as an attachment and shown inline at the top of the task or comment, together with the session metadata.

## Disconnect

To disconnect Asana, go to the [Asana integration page](https://testingbot.com/members/integrations/asana) and click **Disconnect**. Type `Disconnect` in the confirmation dialog to confirm.

Tasks that were already linked to your tests stay linked and are not removed. You can reconnect at any time; reconnecting with the same or another Asana account does not affect previously created tasks.

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

[Email us](https://testingbot.com/contact/new)[Slack Join our Slack](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)