OneDrive for Slack

If you use Microsoft OneDrive to host and manage your files in the cloud, you can install the OneDrive app for Slack to search, share, and preview your files right from your workspace.

What to expect

  • Office 365 accounts (SharePoint Online, OneDrive for Business, Office 365 Enterprise) and non-Enterprise Microsoft accounts (OneDrive and OneDrive Basic) can use the OneDrive Slack app.
  • On-premises SharePoint installations or Office 365 plans hosted on a Microsoft national cloud deployment (Office 365 U.S. Government, Office 365 Germany, and Office 365 operated by 21Vianet in China) are not currently supported.

Note: When you create and share OneDrive files in Slack, you can search for them in your workspace, but they'll only be stored in OneDrive.


Connect OneDrive to Slack

To use the OneDrive app in Slack, one person from your workspace needs to install the app. Then, members can connect their OneDrive accounts to Slack.

Install the OneDrive app

  1. Visit the OneDrive page in the Slack App Directory.
  2. Click Add to Slack.
  3. Click Allow to grant OneDrive access to your workspace.
  4. When prompted, sign in to your Office 365 account.
  5. Click Accept to authenticate with Slack.
  6. Click Open Slack to return to your workspace.


Connect your account

If the OneDrive app is installed to your workspace, follow the steps below to connect your account: 

  1. From your desktop, click your workspace name in the top left.
  2. Select  Apps from the top of the left sidebar. If you don't see this option, click  More to find it.
  3. Search for and select Microsoft OneDrive.
  4. From the Messages tab, click Connect.
  5. Click Allow to grant OneDrive access to your workspace.
  6. When prompted, sign in to your Office 365 account.
  7. Click Open Slack to return to your workspace.


Create OneDrive files from Slack

  1. From any conversation, click the  paper clip icon to the right of the message field.
  2. Select  Create new.
  3. Below Microsoft OneDrive, choose the type of file you'd like to create.
  4. Enter a title for your file. You can also include a message, if you’d like.
  5. Below Post file in, open the drop-down menu and select a conversation.
  6. Click Create to share your new file. 


Share OneDrive files in Slack

  1. From any conversation, click the  paper clip icon to the right of the message field.
  2. Below Add a file from, select OneDrive. If you haven't signed in to your OneDrive account yet, you'll be prompted to do so.
  3. Choose which file(s) to share, then click Open.

After you send your message, the file(s) will expand to show a preview and link back to OneDrive.

Note: It's not currently possible to share folders or OneNote files to Slack.


Manage access to files

If any members you've shared a file with don't have access to view or edit it, the OneDrive app will message you in Slack. From this message, you can adjust access to the file. To change access in the future, you can re-share the file and make adjustments:

  1. Next to a OneDrive file you’ve shared, open the drop-down menu.
  2. Choose who can view the file: Anyone in the conversation, Anyone in your organization, or Anyone with the link.
  3. If you’d like, you can also decide who can edit the file: Anyone in your organization or Anyone in the conversation.

Prompt to manage file access after sharing a OneDrive file in Slack

Note: Options for managing file access will only be visible for files shared in channels with fewer than 100 people.


Manage file previews

When you share a OneDrive file in Slack, you can choose if you'd like a preview to display:

  • Add a preview
    A preview will be displayed when you share the file
  • Don’t add a preview
    A preview will not be displayed when you share the file, but other file information will be visible
  • Don’t add a preview or ask me again
    Previews will never be displayed when you share files, and you won’t see preview prompts

Tip: To reset your file preview preferences, type the /onedrive slash command into the message field, send the message, and click Reset. The next time you share a file, you’ll see the option to set a new preference.


Disconnect your account

If you no longer need to use OneDrive, you can disconnect your account. This will not uninstall the app from your workspace.

  1. From any conversation, type the /onedrive slash command into the message field and send your message.
  2. Click Disconnect.
  3. Click Disconnect to confirm.