Legacy Client

New Client

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 August 17th, 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 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 re-connect 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. Check the boxes to confirm 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 re-authorize their accounts

To use the new app, members of your workspace will need to re-authorize their accounts. Members will be prompted to re-authorize 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 is installed, anyone in your workspace can connect their Asana account with Slack to use it. 

  1. Head to the Asana app page in the Slack App Directory.
  2. Click Add to Slack. If the Asana app is already 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 is 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. Type /asana settings into the message field and send your message. 
  4. Click Connect Asana to Slack
  5. Select Allow to grant Asana access to Slack. 
  6. Click Open Slack to return to your workspace. 

Tip: After connecting your account, Asana will generate a default Asana domain where any tasks 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 you want to link to an Asana project. 
  2. Type the /asana link slash command into the message field and send your message. 
  3. Choose the project you'd like to link from the drop-down menu. 
  4. 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, type /asana link in the message field and send your message. Then, click Unlink below the project you want 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. Below Asana, 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 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 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. Type /asana settings into the message field and send your message. 
  4. 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. Type /asana settings into the message field and send your message. 
  4. 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 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 organization:

  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. Type /asana settings into the message field and send your message. 
  4. 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 you 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. Type /asana settings into the message field and send your message. 
  4. Below Deauthorize your Asana account, click Deauthorize.

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

Related Articles

Recently Viewed Articles