Listing your App

Your listing in the Intercom App Store is how customers discover, learn about and install your app. You should use this space to really ‘sell’ your app, telling a compelling story about its benefits and what it helps customers do.

Once you've published your app to the store and received your first 5 installs, make sure to sign up for our App Partner Program and unlock revenue-driving partnership opportunities.

Here are the requirements to create an effective listing:

App icon

Your app icon should be eye catching and recognizable. Avoid text and too much detail. The icon will be small, so bold and simple works best. Additional criteria include:

  • The image needs to be 512px by 512px and PNG format. (Make sure that the image is not pixelated or stretched).
  • You must have the right to use the image.
  • Your icon cannot contain any form of the Intercom logo.

App name

Customers browsing the store will see your app's name first, so make it punchy, memorable and easy to search. A great name will give customers an indication of what the app does. Your app name:

  • Must be 40 characters or less
  • Must be a unique name in the store
  • Can be your product or company's name
  • Must not contain Intercom

Short description

Here you should outline a clear value proposition or job to be done (e.g., “Notify customers about issues to cut down on questions,” “Seamlessly book meetings with leads and customers,” or “Convert your hottest leads right from Slack”).

Make sure your short description is punchy, concise and intriguing, so that customers click to find out more. The description should focus on your Intercom app specifically — not your product more generally — and should:

  • Be 70 characters or less
  • Use sentence capitalization
  • Not end with a period or full stop

Built by

This should be your company name. It can be the same as your app name.

Terms of service URL

This is the URL where customers can read your company's terms of service.

Privacy policy URL

This is the URL where customers can read your company's privacy policy.

Tell us how you sell your app

Customers feel more confident in choosing an app when they understand the cost. In this section, you should select the pricing model that best describes how customers will access your app ("Free," "Trial for free," "Some features free," or "Paid app"). If customers will need to pay, you should also list the URL for your pricing page.

Documentation URL

This is the URL for your app's help doc. Make it easy for customers to learn more and get help.

Support email address

This is your team's support email address. Enable customers to easily reach out if they need support. If you use Intercom for support, you can forward these emails to your Inbox and manage all of your conversations in one place.

Workspace avatars

Make your listing feel more personal by showing your team's avatars. List here the id for the workspace from which your teammate avatars will be fetched. Your workspace id is the unique code assigned to your app when you create it in Intercom. You can find it by checking the URL of any page you have open in Intercom. It's the string of characters that comes after apps/ in the URL.

Website URL

This is the URL where customers can access your company's website and learn more.

Long description

This is your opportunity to really let your app shine. An impactful long description:

  • Is 2-3 short paragraphs (or bullet points if helpful) and uses sentence capitalization (not all caps)
  • Focuses on why customers should use your app (i.e., the benefits of using it and the results customers might expect), rather than how
  • Includes specific examples or use cases to help customers envision the ways in which they might use your app
  • Is tailored to Intercom customers — B2B and B2C companies ranging from SMB to enterprise and using Intercom for support, sales, and/or marketing (for more details on what we offer, check out our website)

Here’s a structure you can use if you like:

  • Paragraph 1: Tee up the key benefit of your app, the problem you solve, and the core use case or example.
  • Paragraph 2: Delve into additional benefits and/or use cases, and if needed, provide more context on your own product or service.
  • Paragraph 3 (optional): Just one sentence that links to a page for users to find more details (e.g., a landing page for the app).

Note

Please make sure that all of your line breaks appear correctly, such that you don't have too much or too little space between paragraphs. You can preview your formatting by clicking the "Open Preview" button on the righthand side when editing your app listing in your Developer Hub.

Promotional video (optional)

Having a video is not a requirement to be published on the App Store, but it is a powerful way to show customers the value of your app and boost install rates. A few pointers for a successful video:

  • Keep your video short (we recommend 30-60 seconds) and focus on the key benefits of your app (not the details of how to use it).
  • Make sure your video is about your app – and the value of using your product and Intercom together – and is not solely about your product.
  • Upload your video to Youtube, Vimeo, Wistia or Loom in order to add it to your listing.

Pro Tip

Use Loom or ScreenFlow (or your preferred video recording and editing software) to capture your app in action and record yourself on your front-facing camera – adding a human touch makes your content clearer and more engaging. See the Google Analytics listing for an example.

App images

Images help customers quickly understand what your app does and let you highlight key features. Customers rely heavily on listing images when evaluating apps. The best images highlight the key benefits of your app, and each one typically includes a brief benefit statement and a zoomed-in screenshot of part of your app (not just your product). Your listing must have 3-5 images that are:

  • At least 1600px by 1000px (8:5 ratio)
  • PNG format
  • Less than 21MB
  • Not pixelated or stretched

Good images are ones that:

  • ✅ Reflect the brand and identity of your app or product
  • ✅ Combine cropped, focused, or layered screenshots with text
  • ✅ Use text to highlight the value and benefits of your app, or to walk through features
  • 🚫 Avoid full, uncropped, and unannotated screenshots
  • 🚫 Avoid irrelevant use of photography (focus instead on the features and benefits of your app)

Here are a few examples of good images:

Pro Tip

Use our internal template (in Keynote, Figma, or Powerpoint—or upload the Powerpoint version to Google Drive and use it there), or create your own (websites like Canva are great resources for simple but powerful design).

Categories

App Store visitors can browse apps by category. Please select the 1-2 categories you think best describe your app.

Using the Intercom logo

If you’re using our logo in any of your marketing materials, please follow the guidelines and use the brand assets available on our Press Resources page. Please do not modify or animate our logo in any way.

Updated 2 months ago


What's Next

Discover how to submit your App store listing and publish your app successfully by following the guide below.

Review & Publish Your App

Listing your App


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.