Asana for Slack

With the Asana app for Slack, you can manage work more efficiently and make discussions in Slack actionable. Link projects to channels, create new tasks from messages in your workspace and get notified of important Asana project updates – all without leaving Slack.

Note: In August 2020, Asana released a new version of the Asana app for Slack to the Slack App Directory. Support for the legacy version will end in November 2020.


Migrate from the legacy Asana app

Slack customers who installed the Asana app prior to 17th August 2020 will need to update to the new version of the app before November 2020. Follow the steps below to remove the legacy app, then install the new version. 

Tip: If you never used the legacy Asana app, skip ahead to install the current version.  

What to expect

  • Any configurations that you set up for the legacy app will be imported to the new app.
  • The /asana slash commands will immediately be linked to the new app, so be sure to remove the legacy app to prevent errors.
  • Members will need to reconnect their Asana accounts.


Step 1: Remove the legacy app

When you're ready to migrate, follow the steps below to remove the legacy Asana app from your workspace: 

  1. Visit the Asana (legacy) page in the Slack App Directory.
  2. Below the Asana logo, click the Settings button. 
  3. Click Workspace access in the left column. 
  4. Below Uninstall Asana, click Uninstall app
  5. Tick the boxes to confirm that Asana will no longer have access to your workspace and your members will no longer be able to use the app. 
  6. Click Uninstall app


Step 2: Install the new app

Follow the steps below to install the new Asana app to Slack. 


Step 3: Ask members to reauthorise their accounts

To use the new app, members of your workspace will need to reauthorise their accounts. Members will be prompted to reauthorise if they interact with an Asana link or task shared in Slack, or they can follow the steps below


Install the Asana app to Slack

Install the app

Any member with permission to install apps can add the Asana app to your workspace. Once the app has been installed, anyone in your workspace can connect their Asana account with Slack to use it. 

  1. Head over to the Asana app page in the Slack App Directory.
  2. Click on Add to Slack. If the Asana app has already been installed to your workspace, you'll see the option to Open in Slack
  3. Click Allow to grant Asana access to Slack. 
  4. Click Open Slack to return to your workspace. 


Connect your account

Once the app has been installed, any members of your workspace who'd like to use it can connect their Asana accounts. 

  1. From your desktop, click  Apps at the top of your left sidebar. If you don't see this option, click  More to find it.
  2. Search for and select Asana. 
  3. From the Messages tab, click Connect to Asana
  4. Select Allow to grant Asana access to Slack. If you're not signed in to your Asana account, you'll be prompted to do so.
  5. Click Allow again. 
  6. Click Open Slack to return to your workspace. 

Tip: After connecting your account, Asana will generate a default Asana domain where any tasks that you create from Slack will be saved. If you need to create tasks in a different Asana account, you can change your domain at any time. 


Use Asana in Slack

Link projects to conversations

Link an Asana project to a channel or direct message (DM) to keep track of work happening on a particular project in one place: 

  1. From your desktop, open the channel or DM that you'd like to link to an Asana project. 
  2. Click the  lightning bolt icon to the left of the message field to open the shortcuts menu.
  3. Type /asana link into the search field at the top of the menu. 
  4. Click Send to message input to add the slash command to the message field.
  5. Send the message.  
  6. Choose the project that you'd like to link from the drop-down menu. 
  7. The app will post a message to the conversation letting all members know that an Asana project has been linked. 

The app will post updates to the conversation whenever the project is updated in Asana. To unlink a project, follow the steps above to use the /asana link slash command. Then click Unlink below the project that you'd like to remove. 


Create tasks

You can create Asana tasks from the shortcuts menu, or from specific messages using the Asana message shortcut: 

  • Click the  lightning bolt icon to the left of the message field to open the shortcuts menu. Search for Asana, then select Create a task to fill in your task details. 
  • Hover over a message and click the  three dots icon. Then, select Create a task from the menu. 


Share Asana links

Copy and paste links to Asana tasks, milestones, projects and statuses in Slack so that others can easily take one of the following actions: 

  • Mark a task as complete
  • Like a task
  • Change or add an assignee
  • Change or add a due date
  • Add a task to a project
  • Open a task to view it in Asana

Note: If you share a task in a private project with someone who isn't a project member, they'll need to request access from the project owner in order to take actions.


Manage app settings

Update your notification preferences

You can choose if you'd like to receive notifications from the Asana app for tasks that you're assigned or following.

  1. From your desktop, click  Apps at the top of the left sidebar. If you don't see this option, click  More to find it. 
  2. Search for and select Asana. 
  3. Click the  lightning bolt icon to the left of the message field to open the shortcuts menu. 
  4. Type /asana settings into the search field at the top of the menu.
  5. Click Send to message input.
  6. Send the message.  
  7. Below Notifications about tasks, click Turn on to enable notifications. To stop receiving notifications, click Turned on

Note: You won't receive notifications in Slack when you're active in Asana.

Manage link previews

By default, previews will not display when you share Asana links in Slack. To display them, follow the steps below:

  1. From your desktop, click  Apps at the top of the left sidebar. If you don't see this option, click  More to find it. 
  2. Search for and select Asana. 
  3. Click the  lightning bolt icon to the left of the message field to open the shortcuts menu. 
  4. Type /asana settings into the search field at the top of the menu.
  5. Click Send to message input.
  6. Send the message.
  7. Below Display link previews, choose an option from the drop-down menu. 


Change your default domain

When you connect your Asana account, the Asana app generates a default domain where tasks that you create in Slack will be saved. If you work with more than one group in Asana, you can change your default domain to save tasks to a different Asana workspace or organisation:

  1. From your desktop, click  Apps at the top of the left sidebar. If you don't see this option, click  More to find it. 
  2. Search for and select Asana.
  3. Click the  lightning bolt icon to the left of the message field to open the shortcuts menu.
  4. Type /asana settings into the search field at the top of the menu.
  5. Click Send to message input
  6. Send the message. 
  7. Below Change default domain, open the drop-down menu to select a different domain. 


Disconnect your account

If you no longer want to use the Asana app in Slack, you can disconnect your account. Any project notifications that you have subscribed to will stop being sent to channels. 

  1. From your desktop, click  Apps at the top of the left sidebar. If you don't see this option, click  More to find it. 
  2. Search for and select Asana. 
  3. Click the  lightning bolt icon to the left of the message field to open the shortcuts menu. 
  4. Type /asana settings into the search field at the top of the menu.
  5. Click Send to message input.
  6. Send the message. 
  7. Below Deauthorise your Asana account, click Deauthorise.

Note: To uninstall the Asana app, follow the steps in Remove apps and custom integrations from your workspace.