Guidelines for App Directory listings

You can now submit new Slack apps to the Slack App Directory. Build a new app or migrate an existing one now.
The rundown
Read this if:You're still experimenting, prototyping, and exploring.
Read next:Starting with Slack apps

People learn about your app and decide whether to install it by viewing your listing in the App Directory.

Use this space to tell your app's story, compellingly preview your app's capabilities and user experience, and ultimately attract users.

Help people understand what your app does with demonstrations of utility and personality using video, images, text, and more.

Let's learn what goes into a great App Directory listing - and help your app get approved - by following our guidelines:

Your app's name

A great name can evoke the experience of what it's like to use your app. Choose a name that's easy to remember, say, search for, and spell (no emojis 😔). Maybe something sassy.


  • Keep it short and snappy, and not longer than 35 characters.
  • Be distinctive without being obscure.

App Description

Straight forward, straight to the point, straight to the heart. Your description is a powerful tool to communicate how your app will make people's lives at work better. We've written more on creating great descriptions.

We give you two opportunities to describe your app: a long and a short description.

Short description

Be brief; concise. Use fewer than ten words.

Longer description

Provide 3-5 sentences about who your app is for, what your app does, and how it will help them get work done (or maybe fill their life with a little bit of fun). Be clear and clever.

Embolden your text, italicize, and link as desired with simple mark up:

This is a *strong message*. This _is emphatic_. This <|links somewhere relevant>.

This is a strong message. This is emphatic. This links somewhere relevant.


  • Use active voice and speak to users directly. (Speaking in a passive voice makes sentences weaker.)
  • Make your long description easier to read with simple Slack formatting mark up.
  • Don't stuff your description with keywords — it's distracting and won't help your app's discoverability.

Hiretron's description is right on

App Icon

Your app icon should catch people's eye — or stop their thumb — when they're scrolling through the directory. Make it unique, distinctive, and simple enough to pass the squint test.


  • We'll show your icon in several places and at a few different sizes around Slack. Keep it simple so people can understand what it is, even at a small size.
  • Please don't submit something that resembles the Slack logo or Slackbot.
  • Your icon should be 512x512px or bigger and have a full-bleed background.

A icon we like. An icon we think is bad. Don't try this at home.

Images and screenshots

Screenshots can give people a sense of how your app works, and can illustrate important features introduced by your long description.

You can add up to six high-res app images to your app page. Start with a couple app images that show your app being used inside Slack, and reserve a couple spots to specifically highlight your app's most valuable features.


  • Use our design templates to guide your app image.
  • Images need to be 1600px by 1000px (8:5 ratio).
  • Avoid showing specific devices, like phones or laptops. Please show your app in the context of Slack, not other tools.
  • We accept .jpg, .jpeg, and .png file types. Files should be under 21mb, please.

A rather informative screen shot


Videos might be the single most efficient way to communicate the benefits of using your app. You can add a YouTube video to your App Directory page.

You can say a lot by creating a screencast with minimal editing, or you can go full-production with animation. How you tell your story is up to you.

Whichever direction you take, be sure to tell people how your app works, who it's for, and what they can accomplish with it within Slack.


  • Keep it short and sweet: somewhere between 30-90 seconds is a good rule of thumb.
  • Your video will need to be a publicly-accessible YouTube link, not a link to a channel or playlist.
  • Make sure to turn on closed captioning and turn off ads in YouTube's settings before submitting your link.
  • Show your app specifically in the context of the Slack client UIs.

App Card Color

Your app has a profile inside Slack, just like people do. When you upload your app to the directory, you can pick a color that reflects your brand. It's like your app's aura.


  • Pick a color that complements your app icon, since it'll be shown behind it in your app profile within the Slack client.
  • Choose a color that works well with white text so that everyone can see your app's plumage.

A tasteful blue for Hiretron


People browse Slack apps from a selection of popular categories in the App Directory. Choose up to three categories from this list:

  • Analytics
  • Bots
  • Communication
  • Customer Support
  • Design
  • Developer Tools
  • File Management
  • Health & Wellness
  • HR & Team Culture
  • Marketing
  • Office Management
  • Finance
  • Productivity
  • Project Management
  • Sales
  • Security & Compliance
  • Social & Fun
  • Travel
  • Voice & Video
  • Media & News


  • When picking categories, think about who is most likely to use your app and what they'll want to use it for. Consider the places they'll be most likely to look for a solution like yours.

Slack app suggestions

One way teams can discover your Slack app without having to browse for it in the Slack app directory is by having Slackbot suggest installing it when users mention links associated with your app.

By adding a small amount of HTML metadata to your site templates as explained here, app suggestions will be enabled for your app.

Don't forget

Make sure you don't infringe on anyone else's trademark or copyright - those belonging to Slack or otherwise.

Design templates

Our flattened template

Consult our app-directory-assets Github repository for the most up to date templates and resources.

You'll find:

Of course, you've already followed our guide to preparing your app for the App Directory, right?