Org-wide app overview
If you want your Slack app to reach the most people, build an app that can be deployed across an Enterprise Grid organization. Org-wide apps have the potential for effortless, widespread deployment—by some of the largest users of Slack in the world.
If you want more details on building a single-workspace app that works on Enterprise, check out our other documentation here.
If you want to start with a refresher on what apps can do generally, look no further than our start guide.
Otherwise, read on for more details on how to deploy an app across an entire Grid organization.
- Grid refresher
- What's an org-wide app?
- Read more
Enterprise organizations are able to combine multiple workspaces in one organization. You can read more on the model of Enterprise to get a better sense of what to expect.
Until the release of org-wide apps, supporting apps on Enterprise Grid meant apps had to be installed separately on each workspace. This was difficult for administrators to maintain and for developers to manage, since each app required a separate OAuth token for each workspace.
An org-wide app is an extension of a regular Slack app—the difference is that it can be deployed across an entire organization. These apps are installed once, at the org level, and have a single token that represents the permissions for the app on many workspaces.
Here are some of the benefits for your users:
- Org Admins will now be able to distribute apps easily across all workspaces.
- Pre-approved apps can be automatically installed when a workspace is created.
- Users only have to authenticate with an app once for all workspaces that have access to the app.
Although apps that are installed on an Enterprise org look pretty similar to apps installed on a single workspace, there are a few changes to be aware of. Here's a host of information on how to ready your app for org-wide deployment:
Read our walkthrough for making your app Enterprise-ready. You'll find hints on how your app should handle users and channels that span multiple workspaces.
Once your app is successfully scaled to handle Enterprise organizations, check out this list of changes to the pattern of OAuth & Installation for an app across an Enterprise org.
Now that your app is successfully deployed on an Enterprise organization, you can read up on changes to APIs and events.
If you want some quick tips on turning an single-workspace Enterprise app into an org-ready one, look no further.
Our reference page gives a grab-bag of samples: event payloads, API calls, OAuth installation, and methods that use
team_id with org-wide app tokens.