Connect Asana to OverlayQA
Connecting Asana to OverlayQA lets you export captured design QA issues directly to your Asana projects as tasks. Each exported task includes screenshots, CSS selectors, computed CSS values, page URL, viewport size, and browser metadata.
Connect Your Asana Account
Setting up the Asana connection is a one-time process through OAuth authorization.
- In the OverlayQA sidebar, select one or more issues and click Export.
- Choose Asana as the export destination.
- Click Connect to Asana in the export modal.
- An Asana authorization page opens in a new tab. Approve access for OverlayQA.
- The export modal auto-updates when the connection is detected. It polls for up to 2 minutes.
You only need to connect once. After the initial OAuth authorization, OverlayQA remembers your Asana connection for all future exports.
Configure Your Export
After connecting, configure where tasks should land in Asana.
| Setting | Details |
|---|---|
| Workspace | If you belong to multiple Asana workspaces, select which one to use. |
| Project | Choose the Asana project where tasks should be created. |
What Gets Exported
Each exported Asana task includes the following fields.
| Field | Description |
|---|---|
| Name | The issue title from OverlayQA. |
| Notes | Issue description with page URL, Figma frame link, browser and OS info, viewport dimensions, element CSS selector, and computed CSS values. |
| Attachment | Screenshot of the captured area or element. |
What Is Not Exported
Exports include computed CSS values from the live page only. They do not include expected design spec values from Figma. There is no assignee picker in the export UI, so tasks are created without an assignee.
After Exporting
The results screen shows each issue with a clickable link to the created Asana task. Issues are marked as exported in the OverlayQA sidebar. If you try to re-export the same issue to Asana, you will see a warning to prevent duplicate tasks.