> For the complete documentation index, see [llms.txt](https://help.rankability.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rankability.com/account-and-settings/connecting-asana.md).

# Connecting Rankability to Asana

Rankability helps your team create SEO content that ranks and earns AI citations. The native Asana integration carries supported content and workflow handoffs into the Asana projects where your team reviews and delivers that work.

## What the integration does

Connect Asana once for your Rankability organization, then map each Rankability client to the appropriate Asana workspace and project. Supported work can be sent to that project as an Asana task with useful context and a direct link back to Rankability.

The connection does not send every project automatically. You choose when to send a supported Copywriter project, Activity assignment, or monitoring alert.

## Before you connect

You need:

* access to integrations in your Rankability organization;
* permission to manage organization integrations;
* an Asana account that can access the intended workspace and project; and
* approval from your Asana administrator if the workspace restricts third-party apps.

Rankability's Asana app can be authorized by external Asana workspaces. Customers do not need to change any developer or distribution settings.

## Connect Asana

1. Sign in to Rankability.
2. Open **Settings**.
3. Select **Organization → Integrations**.
4. Find **Project management** and choose **Connect Asana**.
5. Sign in to the Asana account that can access the intended projects.
6. Authorize Rankability and return to the integration page.
7. Under **Client mapping**, choose **Choose project** for each client you want to map.
8. Select the Asana **Workspace** and **Project**, then save the destination.

Asana uses a workspace-to-project hierarchy. Unlike ClickUp, there is no intermediate space or list selection.

## Map or change one client's destination

You can also manage a destination from the client:

1. Select the client in Rankability.
2. Open **Settings → Integrations**.
3. Find **Task management** and open **Asana**.
4. Select the **Workspace** and **Project**.
5. Choose **Save destination**.

Use **Change** to send future work to a different project. Changing a destination does not move tasks that Rankability already created in Asana.

The mapping states mean:

* **Not connected** — No project-management provider is connected for the organization.
* **Not mapped** — Asana is connected, but this client has no saved destination.
* **Needs re-selection** — The saved project was deleted, became inaccessible, or is no longer returned by Asana. Choose an available project and save it again.

## Send content and workflow items to Asana

The available action depends on where the work lives:

* **Copywriter:** Open a project and choose **Send to Asana**. Rankability creates a task with the content topic, available project context, and a link to the Copywriter project. A **Copywriter** tag is added when Asana allows it. After a successful handoff, the action links to the existing task as **In Asana** instead of creating a duplicate.
* **Activity:** Open an eligible card, choose **Assign**, and confirm with **Confirm & assign**. The task includes the card summary, a link to Activity, and related Copywriter links when available.
* **Monitoring alerts:** Use **Send to Asana** on a supported alert. The task can include the finding, recommended action, severity or impact context, and a link back to Rankability.

Rankability does not automatically select an assignee, add a due date, publish content, or send every project. Review the task in Asana and add the delivery details your team needs.

## Completion and synchronization

Completion sync is limited to supported linked item types:

| Linked item                             | Completion behavior                                                                                                                                       |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Activity assignment                     | Completing the linked Asana task can complete the Activity item. Completing or dismissing the supported Activity item can complete its linked Asana task. |
| Monitoring alert                        | Completing the Asana task can resolve the linked finding. Resolving the finding in Rankability can complete its linked Asana task.                        |
| Copywriter project sent from the editor | The Asana task links to the project, but task completion does not change the Copywriter project status.                                                   |

This is not universal two-way synchronization. Completing an Asana task does not publish content, and edits to task fields do not rewrite the Rankability project.

## Disconnect Asana

1. Open **Settings → Organization → Integrations**.
2. Find the connected project-management service and choose **Disconnect**.
3. Confirm the disconnection.

Disconnecting removes Rankability's active authorization and clears the saved client project mappings. Tasks already created in Asana remain in Asana. If you reconnect later, review or recreate each client mapping before sending more work.

## Troubleshooting

* **The connection was cancelled or denied:** Start **Connect Asana** again and approve the requested access.
* **The authorization link expired:** Return to Rankability and begin a new connection instead of reusing the old authorization page.
* **An Asana administrator blocks the app:** Ask the Asana administrator to approve Rankability for that workspace.
* **The intended workspace or project is missing:** Confirm that the Asana account you authorized can open it. Reconnect with the correct account if necessary.
* **The client is Not mapped:** Open **Client mapping**, choose the client's project, and save it before trying the handoff again.
* **The destination Needs re-selection:** The original project is no longer available to the connected account. Choose another accessible project and save it.
* **Reconnecting did not restore the old mapping:** Reconnection starts without the cleared client mappings. Map each client again.
* **You authorized the wrong Asana account:** Disconnect Asana, reconnect with the intended account, and recreate the client mappings.

## Related articles

* [Integrations and connected apps](/track/data-integrations-overview.md)
* [Client settings reference](/account-and-settings/client-settings-reference.md)
* [Using Activity](/activity/tasks-board.md)
* [Creating a content project](/copywriter/creating-a-content-project.md)
* [Exporting and publishing content](/copywriter/exporting-your-content.md)