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.


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. 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 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'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. 
  4. Click Send to message input to add the slash command to the message field.
  5. Send the message.  
  6. Choose the project 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 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 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. 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.
  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.
  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 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. 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.
  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 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. 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.
  5. Click Send to message input.
  6. Send the message. 
  7. 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