A new framework for apps (legacy)

Note: Based on feedback, we're changing things up. We're making it simpler for developers to upgrade their apps, and creating a reliable app experience for customers. Read the Slack platform blog for more.

We're updating the way apps are built for Slack: we're laying the technical groundwork for better reliability and improved app management for workspace owners and admins. We have a few apps in our App Directory using this new framework, and additional apps will be added in the coming months. 

Learn about the new app framework

This new framework is best described by the type of ‘tokens’ that apps are built with. A token allows an app to connect with your Slack workspace.

Currently, there are two types of tokens that developers can use for their Slack apps. The main difference between the two is how they connect to your workspace:

  • User tokens
    Most apps today are tied to individual members because they are built with user tokens. This means that apps mirror the access of the user who installs it, and are automatically added to every channel that the user is a part of. Most of the time this behind-the-scenes technical structure goes unnoticed, but if the member that installed the app leaves your workspace, the app that they installed will be disabled.
  • Workspace tokens
    With our new framework, instead of being tied to individuals, apps will connect to your workspace(s) via workspace tokens. The channels to which the app has access can be easily configured at a granular level. And since the apps are not tied to the installer, they’ll stay connected even if the original installer leaves your company and their Slack account is deactivated.

Add apps to your channels

  1. Install one of these new apps just like you would any other app for Slack. See Add apps to your workspace for more.
  2. Choose which channels the app can be used in: all public channels, certain public channels or none at all.

Once installed to your workspace, you can add an app to other channels at any time with one of these options on your desktop:

  • With a slash command: /invite [app name] 
  • From your left sidebar: click the  plus icon next to Apps 
  • From  Channel details in your right sidebar: click + Add app (under Apps)

Remove apps from your workspace

  1. From your desktop, visit Slack’s App Directory.
  2. Search and select the app that you want to remove.
  3. On the app's page, click the Settings button.
  4. From the menu to the left, choose Workspace access.
  5. Click on Uninstall app.

Try an app built on this new framework

  • 💻Github
    A repository service for hosting source code projects. Make use of the git revision control system to keep track of changes.
  • 🛠Sentry
    An open-source error tracking system that shows every crash in your stack as it happens, plus the context to fix those errors.
  • 👩‍💻Zendesk
    A system for tracking, prioritising and solving customer support tickets.

Tip: Interested in building an app on our new framework? Read our API documentation and join our developer preview!