The Slack App Directory Developer Review 👨🏻‍🏭
Tags: webdev, beginners, review
Published: 2018-09-11 10:44:53

---
title: The Slack App Directory Developer Review 👨🏻‍🏭
published: true
description: This is the first in a series where I'll be reviewing down a App Marketplace based on my experience from app development to launch.
cover_image: https://thepracticaldev.s3.amazonaws.com/i/003o4ci8g406kalquola.png
tags: webdev, beginners, review
---

 <section class="post-full-content">
                <div class="post-content">
                    <blockquote>This is the first in a series where I'll be reviewing a App Marketplace based on my experience from app development to launch.</blockquote><p>For this first app marketplace review I'm taking apart the <a href="https://slack.com/apps">Slack App Directory</a>. Publishing my app in the Slack App directory has been by far the best experience from all marketplaces. Slack offers an extremely well executed development and app submission process for developers.</p><p>Slack is a tool that allows teams to communicate in a way that is a crossover between IM and email. Slack claims over eight million daily active users, in 50,000 teams (<a href="https://techcrunch.com/2018/05/08/slack-hits-8-million-daily-active-users-with-3-million-paid-users/">May, 2018</a>).</p><p>The Slack App Directory was launched in 2015 and has grown to over 700+ apps (<a href="https://techcrunch.com/2018/05/08/slack-hits-8-million-daily-active-users-with-3-million-paid-users/">Oct, 2017</a>). Apps can be deeply integrated into the Slack client with an extensive API. The most common usage is implementing (chat)bots.</p><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/slack-app-usage.png" class="kg-image"><figcaption>Trello example: I can add tickets to my board from within Slack with their chatbot.</figcaption></figure><p>Slack shows to be highly committed to their apps ecosystem, inferred from their widespread marketing of apps, ongoing development (recently launched <a href="https://slackhq.com/turn-your-conversations-into-action">Actions</a> and <a href="https://api.slack.com/workspace-apps-preview">Workspace apps</a>), investments (e.g. $80M <a href="https://slack.com/developers/fund">Slack Fund</a>) and extensive communication (e.g. <a href="https://api.slack.com/">documentation</a>, <a href="https://trello.com/c/LqzgzTJq/20-welcome-to-the-slack-platform-roadmap-read-more-here">public roadmap</a>, <a href="https://twitter.com/SlackAPI">Twitter</a>).</p><table><thead><tr><th>In a glance</th><th></th></tr></thead><tbody><tr><td>Company</td><td>Slack</td></tr><tr><td>DAU</td><td>8M</td></tr><tr><td>Apps</td><td>700+</td></tr><tr><td>Requirement</td><td>Slack API integration</td></tr></tbody></table>
<blockquote><strong>Request</strong>: Is your app listed in the Slack App Directory and thriving? Share your <a href="mailto:yvo@yvoschaap.com">experience</a> with me.</blockquote><h2 id="marketplace-access-to-millions-of-users">Marketplace: Access to millions of users?</h2><p>Slack names its app marketplace the <a href="https://www.slack.com/apps">App Directory</a>. The App Directory is easily accessed from the main Slack client. Every team (a group of users) can install up to 10 apps for free. Only users on the paid plan can install more apps. Which, is reported to be over 3 million users (37% from DAU) - unfortunately more statistics on how many teams pay, or app usage are not made public.</p><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/slack-landing.png" class="kg-image"><figcaption>Get Essential Apps, that is a strong CTA.</figcaption></figure><p>The marketplace UX and UI is really well thought out. It's visually appealing and the apps presented look fresh (unlike say the <a href="https://chrome.google.com/webstore/category/extensions">Chrome Web Store</a>). The main page app selection emphasises manual app curation, with on top the section Staff Picks (split into Features, Essential and New &amp; Noteworthy) and for each app category Top Picks stand out that highlight 3 curated apps.</p><p>Compared to other marketplaces there is no clear distinction between free, freemium or trial apps. </p><blockquote><strong>Slack suggestion</strong>: The marketplace should add a clear distinction between free/paid apps, which would help filter out users who don't have the budget to pay for apps. </blockquote><p>Also it isn't clearly labeled who the app developer is, or whether something it is an <em>official</em> app. Also missing are user ratings (unlike say <a href="https://apps.shopify.com/">Shopify</a>) or app reviews. In my opinion both important details for users to see before installing an app - and allowing that app lots of potential invasive permissions.</p><h3 id="browsing-">Browsing:</h3><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/slack-category-1.png" class="kg-image"><figcaption>Staff Picks list curated apps, and every category also highlight a top 3.</figcaption></figure><ul><li>Apps are listed by logo, app name, and a single line description. This gives room for relatively many apps to be listed (30) which is easy to scan and makes an appealing layout for app discovery.</li><li>Paging only allows for next/back, which makes it hard to navigate for users.</li><li>The ordering can't be changed when browsing (unlike searching) which makes it harder to discover the newest apps.</li><li>A big plus; listings are not dominated by major brands like Google or Apple, which gives startups and (indie) app developers a bigger chance to get noticed.</li><li>Search works well. The UX &amp; UI include search autocomplete, keyword highlighting, single line results and endless scrolling results.</li></ul><p>How app listings are ranked is unclear to both the user, as the app developer. There are no statistics shown. I presume it is based on number of app installs. It would be great to be more transparant in how the ranking works, especially for developers.</p><h3 id="app-page-">App page:</h3><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/app-landing.png" class="kg-image"><figcaption>Well designed, but maybe a bit too clean?</figcaption></figure><ul><li>The app page is also well designed: clean, with a large app logo and a distinct CTA button (“Visit site to install” or "Install") asking the user to install the app.</li><li>Screenshots are central to the app page. You can include Youtube videos, but the video thumbnail is a very <a href="https://productledgrowth.slack.com/apps/A6WPL7X27-scrunchbot">low quality</a> (my support <a href="https://twitter.com/yvoschaap/status/1037411491673264128">tweet</a>).</li><li>App description are bit too limited in visible space, and have to manually expand/collapse.</li><li>App permissions are clearly outlined, and very readable for users. But there is no visual distinction to what extend each permission impacts your privacy.</li><li>Unfortunately no install or usage stats available. Other details missing are; pricing, app developer details, and user reviews or ratings.</li></ul><h3 id="app-installation-">App installation:</h3><p>The installation flow is straightforward; Install ⟶ Authorise ⟶ App Landing Page. The App then has permission to access the Slack API for that team. </p><blockquote><strong>Growth tip: </strong>If your app is installed, your app bot should send a welcome message with usage tips, which then appears to the users directly in the Slack client.</blockquote><p>By default any team user can install any app for the whole Slack team. This lowers the barrier to install new apps. Which is a great feature. But for team admins this also means someone else can give permissions to allow an app to read the chat history, view all the member details, and more.</p><p>The marketplace experience in summary:</p><table><thead><tr><th>👍</th><th>👎</th></tr></thead><tbody><tr><td>Clean &amp; fresh looking marketplace</td><td>Only 10 apps allowed per team (free)</td></tr><tr><td>Good app discovery tools</td><td>No usage stats or reviews</td></tr><tr><td>Quality app curation</td><td>No distinction between apps paid/free/trial</td></tr><tr><td></td><td>Maybe the app page too clean?</td></tr></tbody></table>
<p>See ‘<a href="#">Marketing</a>’ to read more about how to let your app can grow with the Slack marketplace. But first, app development...</p><h2 id="development-1-2-3">Development: 1-2-3</h2><p>App development starts at the <a href="https://api.slack.com/">Slack API</a>. Again here Slack show its dedication. The documentation is extensive, up-to-date and features clear API requests/responsive examples. Next to the documentation, a useful <a href="https://api.slack.com/faq">FAQ</a>, many <a href="https://api.slack.com/tutorials">tutorials</a> and a large amount of <a href="https://api.slack.com/community">libraries</a>...</p><blockquote><strong>Dev tip:</strong> Before building, research similar apps in the Slack marketplace and see if - and how they sustain themselves (paid plans, viral growth, etc.)!</blockquote><p>The Slack API is mature and stable. Lots of <a href="https://api.slack.com/methods">methods</a> are available, allowing access to almost anything you need. <a href="https://api.slack.com/incoming-webhooks">Webhooks</a> work really well. <a href="https://api.slack.com/docs/rate-limits">Rate limits</a> are generous. And oAuth 2.0 for permissions handling. </p><p>I haven't heard of apps being killed or important <a href="https://api.slack.com/changelog">endpoints</a> deprecated (unlike <a href="https://techcrunch.com/2018/04/06/twitter-delays-api-change-that-could-break-tweetbot-twitterific-etc/">Twitter</a>) which are all good signs for a sustainable app ecosystem.</p><p>One issue might be that there are so many options to hook into Slack, that if you start off developing, it is all a bit overwhelming.</p><blockquote><strong>Dev tip:</strong> Research Slack in a team with several apps setup to get a broad understanding what make great touch points to build on.</blockquote><p>But all together - in my opinion - a very high quality offering for developers to start building on top of.</p><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/documentation.png" class="kg-image"><figcaption>This is how you do documentation people!</figcaption></figure><h3 id="dashboard-">Dashboard:</h3><p>The Dashboard is where you maintain your apps. The Dashboard is responsive, and contains key features to maintain your app, like your oAuth credentials. The Slack dashboard includes advanced features like revoking keys, admin 2FA, and multi-account access.</p><blockquote><strong>Dev tip:</strong> One confusing bit of the experience is that you have to choose a Slack Team first, before you can create an app. Which quickly leads to apps vanishing if you are not signed in into that specific Team when you created the app. Advice, first create a new slack team only for your app development.</blockquote><h3 id="submission-">Submission:</h3><p>Slack allows any app utilising the Slack API to get listed in their App Directory. The on-boarding is very well thought out, with a clear check list of 36 (!) items. </p><figure class="kg-card kg-image-card"><img src="https://teardown.yvoschaap.com/content/images/2018/09/checklist.png" class="kg-image"><figcaption>The submission process takes you by the hand and demands you to confirm every checklist step that is mandatory before you can submit your app for approval.</figcaption></figure><p>One submission quirk is demanding exact screenshot dimensions (1600 x 1000). Fixed screenshot dimensions are a pain (resize and handle cropping please)!</p><blockquote><strong>Dev tip:</strong> Design templates for <a href="https://github.com/slackapi/app-directory-assets">Sketch and Photoshop</a> are available which is a great way to get started with the right font and dimensions.</blockquote><p>You can't preview your app page before submitting, which leads to unnecessary re-submissions due to for example typo's. It's also unclear if you can use HTML or markdown in the description, which I eventually found out to be a custom <a href="https://api.slack.com/docs/message-formatting">Slack markdown variant</a>. Any change in the app details, needs a re-submission and manual review.</p><blockquote><strong>Growth tip:</strong> Slack has huge SEO value, which they pass on in their directory, so make sure you link back to your website.</blockquote><p>From submission (to having to fix my privacy policy) to <a href="https://www.slack.com/apps/AB35T2M1S-teampage">publication</a> took only <strong>7 days</strong>.</p><p>The development experience in summary:</p><table><thead><tr><th>👍</th><th>👎</th></tr></thead><tbody><tr><td>Great API</td><td>No billing integrations</td></tr><tr><td>Great documentation</td><td>Interactive method requests (testing)</td></tr><tr><td>Fast submission process</td><td>Fixed screenshot image dimensions</td></tr><tr><td>Public roadmap</td><td>App stats missing</td></tr><tr><td>Many libraries available</td><td>No personal point of contact</td></tr></tbody></table>
<h2 id="marketing-to-the-moon">Marketing: To the moon?</h2><p>The Slack app marketplace is quickly accessible from every Slack client. Although Slack claims 700+ apps, new apps can still get prime real estate in the marketplace because of the most visible positions are curated by their team.</p><blockquote><strong>Growth tip:</strong> Get in <a href="#">contact</a> with Slack's dev team to get featured.</blockquote><p>The actual Marketplace traffic is unknown, as is the number of daily installs it drives. I did find a mention of "more than 200 of them [apps] have over a thousand companies actively using them" (<a href="https://medium.com/slack-developer-blog/giving-apps-a-new-home-in-slack-daa2ba3a75ed">Jul, '17</a>).</p><p>It is hard to identify the amount of installs your app can attract by a marketplace listing alone. My general experience is getting your app in a store, won't make your business an overnight success (because don't expect Slack to make it a success for you). This goes for any app marketplace. So make sure your expectations are somewhat realistic.</p><p>The app <a href="https://medium.com/slack-developer-blog/from-zero-to-25-000-mo-bf7caddea44d">Standuply</a> claims after being featured on the marketplace homepage "in two weeks [we] got 750 new signups". Which I think is not that impressive for the most visible position in the marketplace. Also Pull Reminders mentions a "<a href="https://www.indiehackers.com/interview/from-idea-to-profitable-business-on-the-github-marketplace-and-slack-a6ef7d420a">trickle</a>" of new users from the marketplace.</p><p>There are no clear viral tools to grow your installation base beyond a single team, because Slack teams are independent silos, you can't cross promote your app between other teams. This makes your viral growth relient on word-of-mouth. </p><p>I've identified three types of apps, with each potential value with building for Slack:</p><ol><li><strong>Reach</strong>: You have an existing SaaS or app and want to grow your audience by integrating in Slack and reach new customers. <br>These apps might find not much value. E.g. <a href="https://slack.com/apps/AB35T2M1S-teampage?next_id=0">Teampage</a>.</li><li><strong>Feature</strong>: You have an existing SaaS or app, and your users are on Slack and want them to be able to use your tool from there. E.g. <a href="https://trello.com/platforms/slack">Trello</a> or <a href="https://slack.com/apps/AAB31CEKS-wetransfer">Wetransfer</a>.<br>These apps are usually more mature, and have Slack integration as just another feature.</li><li><strong>Focus</strong>: You have an app custom made for Slack. In this case you have more opportunities to make your app integrate into the ecosystem, and get the added-value parts right. E.g. <a href="https://www.heytaco.chat/">HeyTaco</a> and <a href="https://medium.com/slack-developer-blog/from-zero-to-25-000-mo-bf7caddea44d">Standuply</a>.<br>These apps are more invested to make it right, but also more dependent (and limited) on Slack to grow it.</li></ol><blockquote><strong>My experience</strong>: After getting listed with 3 category pages (e.g. Media &amp; News @ #<a href="https://slack.com/apps/category/At7KK5H6AZ-media-news">25</a>). My listing hasn't driven any noticeable traffic &amp; installs to date. Which after all the hype is disappointing. I must note my app has a minor Slack integration (importing team members), so results will vary. I've requested a highlighted spot, which is still pending (update: soon).</blockquote><p>The marketing experience with Slack:</p><table><thead><tr><th>👍</th><th>👎</th></tr></thead><tbody><tr><td>Marketplace is easy accesable for users</td><td>No place where all new apps are promoted</td></tr><tr><td>Curation allows your app to be highlighted</td><td>No performance stats (again)</td></tr><tr><td></td><td>No viral tools to grow beyond a single team</td></tr></tbody></table>
<h2 id="conclusion-do-you-build-for-slack">Conclusion: Do you build for Slack?</h2><p>It's clear Slack is very much invested into their app ecosystem. Apps are tightly integrated into Slack itself. It gives room for both something mainstream as Google Calendar integration as well as something startup-y like smart Scrum bots. </p><p>Anybody using Slack, comes across apps (anecdotal). From an app development point of view Slack is one of the best experience I've seen. Their marketing touch points create lots of opportunities for new apps to be discovered and installed. </p><p>And it all seems to pay off for Slack. But I do think Slack should now take it to the next level by allowing app developers to tap into Slack's billing (similar to <a href="https://www.cloudflare.com/apps/developer/docs/payments-and-billing/products">Cloudflare</a> or <a href="https://developer.github.com/apps/marketplace/pricing-payments-and-free-trials/">Github</a>). Having app developers set pricing plans, and Slack handling the payments...</p><p>Also Slack should be open about app usage to drive more developer adoption. Developer success stories are limited <a href="https://medium.com/slack-developer-blog/3-7m-taco-emojis-later-1ea1799101af">available</a>, and if you compare that with Shopify's "$162K is the average annual earnings for the top 25% of our app developers" there is much to gain here.</p><blockquote><strong>Feedback</strong>: This whole review is experimental so let me know your thoughts or share to support future posts.</blockquote><h2 id="what-s-next-">What's next...</h2><p>Follow me on Twitter @<a href="https://twitter.com/yvoschaap">yvoschaap</a>.</p>

<h3 id="about">About</h3><p>👋 Hi, I'm Yvo Schaap a 32 year old entrepreneur from Amsterdam who loves to code and build great things. See my professional annotated <a href="https://yvoschaap.com/annotate.html">background</a>. Get in touch at <a href="mailto:yvo@yvoschaap.com">yvo@yvoschaap.com</a>.</p><hr><p>This is an editorial review. I am in no way affiliated or paid by Slack.</p>
                </div>
            </section>