Writing an App Store listing for your app

The app listing is your first point of contact with a merchant, and it’s where they’ll look to see if your app is right for them. It’s also your biggest marketing tool — an effective app listing will encourage Shopify merchants to try out your app for themselves. Make sure that your app listing is clear, and that it answers the questions that a potential user might have.

The following app listing guidelines cover all aspects of building on an app listing, including graphics and written content. In the examples below, you can see how the Email My Webhooks app followed these guidelines to make their own app listing more appealing to merchants. Click the See Example buttons to learn more.

App name

Your app’s name plays a large role in how merchants discover it. Choose something simple that’s easy to spell. It’s best to avoid generic terms that are similar to a name of an existing app. You may not use the word "Shopify" in your app’s name.

App icon

The app icon is your app's trademark, and merchants will see it every time they access your app. It should be memorable and communicate a message about your app's purpose. The app icon doesn't need to be the same as your company logo. An attractive icon will improve your brand as a developer.

Icon requirements

  • Keep the corners square. We round the corners for you when we display the icon.
  • Avoid using a white background. Use bold colors and patterns that are recognizable.
  • Make it simple. Focus on one or two elements. Visual clutter can make an icon less effective.
  • Be consistent. The icon and banners for your app should look like they belong to the same brand and product.
  • The icon’s dimensions should be 512px by 512px.

App card banner

Your app’s banner is your first impression, and an extremely valuable tool for converting traffic to into app users. We’ve found that merchants tend to select a well-designed banner when looking for an app that will meet their needs. If you can show that you’ve put time and effort into your banner, then users trust that you’ve done the same with your app. Banners that look good and convey the appropriate message are an incredibly valuable tool for converting traffic to users.

  • Keep the corners square. We round the corners for you when we display the banner.
  • Avoid using a white background. Use bold colors and patterns that are recognizable.
  • Make it simple. Focus on one or two elements. Visual clutter can make a banner less effective.
  • Be consistent. The icon and banners for your app should look like they belong to the same brand and product.
  • The app card banner's dimensions should be 310px by 100px.

Short description

The short description appears in search results on the Shopify App Store. It's what merchants will glance at before they decide whether or not to learn more about your app. Your short description should clearly describe the purpose of your app and its core functionality: what does your app do? Make sure to specify what problem your app solves.

Full description

The full description is the main part of your app listing. It should include details about what your app does, how it works, and how it integrates with Shopify. A great description also includes information about your company in general. When you describe your app, assume that your reader doesn't know anything about it. Put yourself in the shoes of the merchant, and try to answer all the questions that they might have about your app.

Your description is a great place to include what platforms your app integrates with and if an account with another platform is required to use your app. You shouldn’t include your own platform as a requirement.

When you write your description, use HTML elements to organize your content and emphasize the most important information. You can include titles, lists, and other elements to help convey your message more effectively.

Caution

App descriptions can't include testimonials, reviews, and ratings or stars of any kind.

An effective description will answer these questions:

  • What problem does the app solve?
  • How does it solve the problem?
  • How does your app work with Shopify?
  • How will this change the look of my store?
  • How do I get started?

App Requirements and integrations

Make sure to include account requirements in your app listing. If your app needs an account, then make sure to list it so merchants know what type of accounts or features they need for the app to work. For example, you can include requirements like "a Facebook Ads account" or "a Shopify plan with real-time carrier shipping."


If your app integrates with another platform, then make sure to include it in the Integrations list in your app listing. This lets merchants know whether your app integrates with the third-party integration they are already using.

Promotional video

A video isn’t mandatory but we highly suggest including one to tell merchants more about your app. Outline your app's functionality and how your app interacts with Shopify. Merchants want an honest picture of what to expect from your app and how it will help them run their business. You can include brief demos using the app to to highlight core functionality and give merchants perspective.

Video Requirements

  • Videos should be promotional, not instructional. Do not include long screencasts of someone using the application.
  • Videos should be no longer than 2-3 minutes.

Screenshots

Screenshots should showcase your admin interface, and the features that set your app apart from the others. Use images from your app’s interface to show how your app works. If your app changes the look of a merchant's storefront, then include images of that as well.

Screenshot requirements

  • Your app listing should include at least 3 screenshots.
  • Screenshots should be at least 1150px by 750px.

Tip

If you include screenshots that were taken on a large, high-resolution monitor, then merchants who use mobile devices or small screens might not be able to view them properly.

Marketing guidelines

When you describe your app, be honest about its features, and about what merchants can expect when they install and use your app.

  • Promote only the features that you offer. Don’t make false promises about what your app does.
  • Do not use other other brands assets and logos in your app listing unless you've been given explicit permission by the owner.
  • Do not use Shopify trademarks in your app's name, URLs or images.

Visit the Shopify Partner Program agreement to learn more.