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 17, 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:
- Visit the Asana (legacy) page in the Slack App Directory.
- Below the Asana logo, click the Settings button.
- Click Workspace access in the left column.
- Below Uninstall Asana, click Uninstall App.
- 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.
- 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.
- Head to the Asana app page in the Slack App Directory.
- Click Add to Slack. If the Asana app is already installed to your workspace, you'll see the option to Open in Slack.
- Click Allow to grant Asana access to Slack.
- 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.
- From your desktop, click Apps at the top of your left sidebar. If you don't see this option, click More to find it.
- Search for and select Asana.
- From the Messages tab, click Connect to Asana.
- 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.
- Click Allow again.
- 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:
- From your desktop, open the channel or DM you'd like to link to an Asana project.
- Click the lightning bolt icon to the left of the message field to open the shortcuts menu.
- Type /asana link into the search field at the top of the menu.
- Click Send to message input to add the slash command to the message field.
- Send the message.
- Choose the project you'd like to link from the drop-down menu.
- 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.
- From your desktop, click Apps at the top of the left sidebar. If you don't see this option, click More to find it.
- Search for and select Asana.
- Click the lightning bolt icon to the left of the message field to open the shortcuts menu.
- Type /asana settings into the search field at the top of the menu.
- Click Send to message input.
- Send the message.
- 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:
- From your desktop, click Apps at the top of the left sidebar. If you don't see this option, click More to find it.
- Search for and select Asana.
- Click the lightning bolt icon to the left of the message field to open the shortcuts menu.
- Type /asana settings into the search field at the top of the menu.
- Click Send to message input.
- Send the message.
- 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:
- From your desktop, click Apps at the top of the left sidebar. If you don't see this option, click More to find it.
- Search for and select Asana.
- Click the lightning bolt icon to the left of the message field to open the shortcuts menu.
- Type /asana settings into the search field at the top of the menu.
- Click Send to message input.
- Send the message.
- 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.
- From your desktop, click Apps at the top of the left sidebar. If you don't see this option, click More to find it.
- Search for and select Asana.
- Click the lightning bolt icon to the left of the message field to open the shortcuts menu.
- Type /asana settings into the search field at the top of the menu.
- Click Send to message input.
- Send the message.
- 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.