Deploy to Slack

Developing automations requires a paid plan. Don't have a paid plan? Join the Developer Program and provision a sandbox with access to all Slack features for free.

Your apps can be deployed to Slack's managed infrastructure by executing slack deploy at the root of your project. No local development server is started with slack deploy.

npm dependencies are supported but are still in beta, so ensure that you test any npm: specifiers when using slack deploy (slack run is not affected).

Using slack deploy

When you execute slack deploy and you are logged into a Slack Enterprise Grid, you may also be asked to select a workspace within your organization to deploy your app to (default is all workspaces).

You may also specify a workspace within your organization to grant your app access to with the --org-workspace-grant flag.

The CLI will package up your app and deploy it to the workspace you specify. At that point, anyone in your workspace will be able to find and add your app by navigating to Apps > Manage > Browse apps.

The deploy command behavior may vary slightly based on the operating system used.

Function distribution

To distribute a function so that another user (or group of users) can build workflows that reference your function after you deploy your app, you can execute the slack function distribute command. After choosing your workspace, you'll also be prompted to select which function you want to deploy, as well as who you would like to give access to your function -- app collaborators only, specific users, or everyone. Your function will then be distributed to those users the next time you deploy your app.

✨ For more information about distributing functions, refer to distribute a custom function.

Workflow apps are currently not eligible for distributing to the App Directory.

Re-deploying your app

If you need to make any changes to your app, you must redeploy it using slack deploy.

In addition, if administrators of your workspace have enabled admin-approved apps, it means your app will need approval before it can be deployed or redeployed to your workspace.

✨ For more information about getting your app approved, check out access controls for developers.

Have 2 minutes to provide some feedback?

We'd love to hear about your experience building Slack automations. Please complete our short survey so we can use your feedback to improve.