Get Slack notifications of new comments and mentions on your boards and other changes related to your profile, respond to them instantly, easily share your Miro boards from within Slack, and automatically unfurl board links. Read the article to learn how to connect your Slack to Miro and get access to all the nice features.
✏️ Some Slack users are suggested to seamlessly register with Miro via Slack when clicking a link to a Miro board posted in a Slack channel. The feature is currently in beta and managed by Slack. It does not require our application to be installed in the Slack workspace.
Workspace administrators have the option to completely disable the Sign in with Slack feature in the Slack workspace settings (App Management Settings > Sign in with Slack Settings). Enterprise Grid Org and their workspaces are excluded from the launch during beta.
In this article:
- Enabling the app
- Configuring notifications
- Reacting to notifications right in Slack
- Unfurling board links
- Sharing a board from Slack
- Disabling the app
- Frequently asked questions and possible issues
Enabling the App
Slack App integration is set up by a user for their own profile. To enable the integration, open your Profile Settings > Integrations, find Miro Feed (Slack App) and click Connect:
Connecting Slack App
Another option is to enable it right in the Notifications tab:
Enabling Slack App on the notification page
You will be redirected to authorize in Slack. Please enter your credentials and sign in to Slack.
Authorizing in Slack
Customize the feed that you receive by choosing the events you'd like to be notified about.
You can keep track of the following events:
- invitees sign up
- someone requests access to a team or a board
- a new board is created in one of your projects
- a board is shared with you
- there's a new comment on your board or a reply to your comment on a board
- someone @mentions you in a comment or reply
Open the Notifications page and set up your preferences:
Keep in mind that in some cases the notification will be sent to you only if the notifier decides to send it out.
Reacting to notifications right in Slack
When someone requests access to your board you can grant in right in Slack. Choose the option and click the button:
Granting access to a board in the Slack channel
Unfurling board links
The latest version of Miro Slack app unfurl links to Miro boards by adding the board names, description, and board covers.
Board name, description, and cover in Slack channel
Reinstall your Slack integration to get access to the feature: go to Miro Profile settings > Integrations and click Log out next to Miro Feed (Slack App). Then click Connect and re-authorize.
✏️ To re-authorize, you may need to receive approval from the Slack Workspace admin.
To set a board cover, open the board settings by clicking the title in the upper-left corner of your board. On the pop-up window, click the image in the upper-right corner and upload a picture from your device or select a section from the board. The cover will then appear in Slack when you share the board link.
Setting board cover
Sharing a board from Slack
When posting a board link in Slack you will see a notification showing the users that don't have access to the board. You can easily invite them to the board right via Slack. Feel free to make the board public so that anyone with the link can view/comment it.
💡 If the option is not available for you, please re-install the app in settings or ask your admin to update the plugin in Slack Marketplace.
Creating a board from Slack
You can use the Miro shortcut to create a board from within Slack.
Creating a board from Slack
You will be asked to create a title for the board, select a Miro team, and add a short message to send along with the link to the newly created board within Slack.
Setting parameters for a new board in Slack
Once the board is created, the message will be sent to the channel/conversation along with the board link.
A message will be posted after creating a new board from within Slack
If some channel members do not have access to the newly created board, you'll be suggested to share the board with them from within Slack.
Disabling the App
To disable the integration, go to the Profile settings > Integrations and click Log out:
Disabling Miro Feed
To remove the app from Slack completely, open Miro channel settings in Slack, click Configuration.
Settings of the Miro App
You'll be redirected to the Miro app Settings page. Scroll down, find your name in the list of authorized users and click the trash icon.
Workspace Admins will also see the option to delete the App from the whole workspace.
Removing App from Slack
Frequently Asked Questions and Possible Issues
1. If a user adds Miro to Slack, will Miro be able to read their Slack channels?
- No, Miro will just view basic information about public channels in the workspace. It means that Miro will be able to read the list of channel names and won't be able to read the channel messages.
2. I am getting 'Something went wrong' message when trying to install the Miro Feed for Slack.
- Please check if your browser is allowing pop-ups from the miro.com domain. There may be an extra page asking for app permissions.
3. I am not getting Miro-Slack notifications and re-installing the Miro app in Slack does not help. How can I fix it?
- Please try to re-connect Miro and Slack on the Miro's side (Profile settings > Integrations).