Get started with Asana (Beta)

The Asana integration for Miro enhances collaboration by enabling seamless two-way synchronization between Miro boards and Asana tasks. Easily import, view, and edit tasks without switching between tools, ensuring your workflows stay up to date. This integration is designed to improve task management, making it easier for teams to stay aligned and productive.

⚠️ Administrators may need to authorize Asana integration for their Miro team. Team members can use the Asana integration only if it's installed at the team level.

Authorize and synchronize the Asana account

Before installing the Asana integration, ensure you have an active Miro and Asana account. If you do not have a Miro account, sign up here.

1. Open a Miro board.
2. In the Creation bar, select Tools > Media & Integrations (+).
3. Search for Asana (Beta).
4. Click Connect to authorize the Asana integration and follow the instructions.

Once connected, you'll see a message that your account is being synchronized. This process can take from several minutes up to several hours.

Once synchronized, you'll receive an email saying that your Asana account sync is complete.

Import and use Asana tasks

After Miro is connected and synchronized to your Asana account, you can add Asana tasks to your Miro boards:

1. Open a Miro board.
2. In the Creation bar, select Tools > Media & Integrations (+).

3. Search for Asana (Beta).

   The Asana task picker will appear, allowing you to filter tasks by Status, Assignee, and Project.

4. Select tasks to import, and they will appear as Asana Card Widgets on your Miro board.

✏️ The picker will display only those tasks that you have access to within Asana. If a Miro user opens the source page of a task to which they don’t have access, they will see an inaccessible message.

Edit Asana tasks

To edit Asana tasks on a Miro board:

1. Click an Asana card widget to open the context menu.

   

2. Click the side panel icon.
   This opens a side panel with ticket details.
3. Edit task properties directly in Miro, and then click Update.
   Changes will be reflected in Asana.

Manage Asana cards

When you import Asana tasks to Miro, you can manage them in various ways.

Organize tasks in Miro tools

Use tools like Table, Timeline, Columns, or User story mapping to organize Asana tasks:

1. Import Asana tasks to your Miro board.
2. Drag and drop the Asana cards into your chosen tool. For example, a Table.
3. Rearrange Asana cards as needed to reflect your team’s workflow or task status.

Open the original Asana task

You can quickly navigate to the full task in Asana:

1. Click on an Asana card widget to open the detail view.
2. In the detail view, locate and click the Source icon.
3. The task will open in a new browser tab in the Asana interface.

Alternatively, click the Source icon in the Ticket details side panel. 

Switch between detail views

Choose how you prefer to view task details in Miro:

1. Click an Asana card widget.
2. The task opens in a side panel detail view by default.
3. Click the Switch view icon to open the task in a modal window instead of the side panel.

To return to the side panel, click Switch view again.

Change a card’s color

Color-coding tasks can help visually distinguish priority or status:

1. Select the Asana card you want to recolor.
2. In the context menu, click the Fill color icon.
3. Select the desired color from the palette.

Create Action shortcuts

You can create Action shortcuts to:

• Open the Asana Ticket picker.
• Create a new Asana card.

How to uninstall the Asana integration

You can uninstall the Asana integration at the team or individual level.

Team-level uninstallation

1. Open Team settings > Apps & Integrations.
2. Find Asana Ticketing in the list of installed apps.
3. Scroll down and click Uninstall for team.

Individual uninstallation

1. Navigate to Apps & Integrations in your Miro settings.
2. Locate Asana Ticketing and click Uninstall for me.

By following these steps, you can seamlessly integrate and manage your Asana tasks within Miro, improving workflow efficiency and collaboration across both platforms.

Frequently asked questions

• Which Asana users can utilize the Asana integration within Miro? Only authorized users who are part of the Miro team or organization where the board is hosted can use the Asana integration. Additionally, these users must possess the necessary permissions within Asana itself to interact with the tasks.
• Who can see the Asana tasks once they are imported into a Miro board? Any user with access to the Miro board (i.e., those with view, comment, or edit permissions for the board) can view the imported Asana data. Importantly, users do not require Asana authorization or an Asana license to simply view the imported task data displayed on the Miro board.
• Why is the Asana integration currently in a Beta phase, and what does this mean for security? The "Beta" status indicates that the user experience is still under active development and refinement. Miro is actively seeking feedback from users to enhance the integration. From a security standpoint, security remains a paramount concern for Miro, even for Beta features. The Asana integration Beta has successfully undergone a security review by the Miro security team, adhering to Miro’s internal security guidelines.
• Can I access or view Asana tasks through the Miro integration if I do not have direct access to them in Asana? No, each user interacts with the Asana integration using their individual Asana account. This means that users can only search for, import, or edit Asana tasks within Miro in accordance with the permissions they already hold within the Asana system. However, once tasks are imported onto a Miro board, they become visible to all other users who have access to that specific Miro board.