---
title: Best practices for apps in the Shopify App Store
description: >-
  Follow these best practices to make sure your app provides a high-quality
  experience to merchants.
source_url:
  html: 'https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices'
  md: 'https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md'
---

ExpandOn this page

* [General best practices for all apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#general-best-practices-for-all-apps)
* [1.​Prohibited and restricted app configurations](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#1-prohibited-and-restricted-app-configurations)
* [2.​Installation and setup](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#2-installation-and-setup)
* [3.​Functionality and quality](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#3-functionality-and-quality)
* [4.​App performance](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#4-app-performance)
* [5.​App listing](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#5-app-listing)
* [6.​Security and merchant risk](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#6-security-and-merchant-risk)
* [7.​Data and user privacy](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#7-data-and-user-privacy)
* [8.​Support](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#8-support)
* [Category-specific best practices](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#category-specific-best-practices)
* [9.​Online store](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#9-online-store)
* [10.​Embedded apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#10-embedded-apps)
* [11.​Product sourcing](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#11-product-sourcing)
* [12.​Mobile app builders](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#12-mobile-app-builders)
* [13.​Sales channels](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#13-sales-channels)
* [14.​Purchase option apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#14-purchase-option-apps)
* [15.​Donation distribution apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#15-donation-distribution-apps)
* [16.​Payments apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#16-payments-apps)
* [17.​Post Purchase apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#17-post-purchase-apps)
* [18.​Checkout apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#18-checkout-apps)
* [19.​Blockchain apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#19-blockchain-apps)
* [Next steps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#next-steps)

# Best practices for apps in the Shopify App Store

These best practices are intended to provide the best experience across the entire app lifecycle, from branding, to installation, to onboarding, functionality, and quality. For a list of all the requirements that need to be met to be eligible for the Shopify App Store, refer to the [App Store requirements](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements).

***

## General best practices for all apps

The best practices in this section apply to [all apps distributed through the Shopify App Store](https://shopify.dev/docs/apps/launch/distribution). Additional [category-specific best practices](#category-specific-best-practices) are presented in the section below.

***

## 1.​Prohibited and restricted app configurations

Some types of apps aren't permitted on the Shopify App Store and others must have their visibility set to limited visibility. See [App Store requirement 1.1](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#build-and-operate-within-shopifys-platform) for more information.

***

## 2.​Installation and setup

Merchants should be able to quickly set up and start using your app. This section describes the correct flows for authentication, app install charges, and any sign-up steps (if required). These best practices make sure that you provide merchants with the guidance they need when they start learning to use your app.

### A.​Authentication

Your app should immediately authorize using [OAuth](https://shopify.dev/docs/apps/build/authentication-authorization) before any other steps occur, even if the merchant has previously installed and then uninstalled your app. See [App Store requirement 2.3](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#provide-seamless-and-secure-installation) for more information.

### B.​Permissions

[Permissions](https://shopify.dev/docs/api/usage/access-scopes) are the levels of access that your app has to a merchant's store through the API. The permissions that you request are shown to the merchant on the OAuth grant page, where the merchant can either grant or decline them. See [App Store requirement 3.2](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#request-only-necessary-access-scopes) for more information.

### C.​Setup and merchant workflows

For merchant security, your app shouldn't use pop-up windows for essential app functionality, like running OAuth or approving app charges. Avoiding the use of pop-up windows also protects your app from being compromised by pop-up blockers.

If your app adds secondary payments to orders because of post-purchase upsells or other order edits, then you consider telling merchants that orders might have multiple payments associated with them. We recommend including a note in your Shopify App Store listing and the app setup instructions to tell merchants that if they're capturing payments manually, then they might need to capture more than one payment for a single order.

See [App Store requirement 2.3](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#provide-seamless-and-secure-installation) for more information.

***

## 3.​Functionality and quality

For your app to be successful, it should offer a consistent and positive experience for the merchants who use it. The following functionality and quality best practices apply to the core features of your app, such as its user interface, performance, and billing.

### A.​User interface

By offering a great user interface, you can make it easier for merchants to use your app to grow their businesses. See the [App Design Guidelines](https://shopify.dev/docs/apps/design) to learn more about how to design and build your app's user interface. Additionally, see the [Functionality](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#functionality) section of the App Store requirements to understand what specific conditions must be met for your app to be eligible for the Shopify App Store.

### B.​Billing

Shopify offers managed pricing as well as an API-based billing system to support different types of app charges. It bills merchants through the same system that's used for their Shopify subscription, and makes it easier for them to keep track of their payments.

Your app should allow merchants to upgrade and downgrade their pricing plan without having to contact your support team or having to reinstall the app. This includes ensuring that the charges are successfully processed in the application charge history page in the merchant admin.

Enterprise-level pricing plans should be referenced in the **Description of additional charges** section of the pricing section of the app's listing.

See [App Store requirement 1.2](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#bill-through-the-shopify-billing-api-or-managed-pricing) for more information.

### C.​State of the app

Caution

Make sure your app is compliant with the latest [Google Chrome cookie behavior](https://www.chromium.org/updates/same-site) and [compatible with the SameSite cookie attribute](https://shopify.dev/docs/apps/build/authentication-authorization/session-tokens).

Merchants are busy, and every minute matters when running their businesses. By making sure that your app performs well, you can help merchants achieve their goals faster and spend more time on the problems that need their attention the most.

Apps that no longer reflect the original core functionality submitted to the App Store will be re-evaluated and will need to be resubmitted for a full App review.

See [App Store requirement 2.1](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#create-reliable-and-user-friendly-apps) for more information.

***

## 4.​App performance

For merchants to be successful, their online stores should have best-in-class speed and user experience. Apps can easily slow down performance, and we require apps to keep performance top-of-mind while helping merchants, to follow our performance requirements and best practices, and to test that their products continue to meet our minimum requirements for speed.

Tip

For best practices and recommendations on app performance, refer to our [app performance recommendations](https://shopify.dev/docs/apps/build/performance).

### A.​Performance score

Your app shouldn't reduce Lighthouse performance scores by more than 10 points. Test your app's impact on Lighthouse performance scores using the steps outlined in [Testing storefront performance](https://shopify.dev/docs/apps/best-practices/performance/storefront#testing-storefront-performance).

### B.​Testing methodology

For apps that affect storefronts directly, Shopify tests the app's effect on store performance by measuring the Lighthouse score before and after the app is installed. We calculate a weighted average of score from the following pages:

| Page | Weight |
| - | - |
| Home | 17% |
| Product details | 40% |
| Collection | 43% |

The difference in the score before and after the app is installed and configured on the above pages indicates whether the app improves or worsens store performance. Your app should consistently demonstrate low or no negative impact on the performance of real merchant stores over time.

Note

Note: Lighthouse scores can vary between runs. Consider running these tests frequently during your development, and averaging your scores across a few consecutive Lighthouse tests before submission.

***

## 5.​App listing

Your app listing is often your biggest marketing tool—an effective listing helps merchants understand how it can help them run their business. Make sure your listing is clear, includes pricing, and showcases your app's benefits.

To create a listing, select [Shopify App Store as the distribution method](https://shopify.dev/docs/apps/launch/distribution/select-distribution-method). All approved public apps have a listing on the Shopify App Store, regardless of whether you choose to make it [full or limited visibility](https://shopify.dev/docs/apps/launch/distribution/visibility)

See [App Store requirements section 4](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#app-store-listing) for more information.

### Example app listing

The following image shows an example app listing, and shows where some of the fields in the app submission form are used in the app listing.

![An example app store listing.](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/example-app-store-listing-Bc1MkRXj.png)

| 1. | [Feature media](#1-feature-media) |
| - | - |
| 2. | [Demo store URL](#2-demo-store-url) |
| 3. | [Screenshots](#3-screenshots) |
| 4. | [App introduction](#4-app-introduction) |
| 5. | [App details](#5-app-details) |
| 6. | [Feature list](#6-feature-list) |
| 7. | [Integrations](#7-integrations) |

### A.​Branding your app

Your app name should be unique and start with your brand name (not a generic descriptor). Lead with your distinctive brand to differentiate from similar apps. For example, "QTeck - Announcement Bar" rather than "Announcement Bar - QTeck". Keep names to 30 characters or fewer. Your app name in the TOML configuration should align with your App Store listing name.

For your app icon, use bold colors and simple, recognizable patterns. Avoid text, screenshots, and Shopify trademarks. Keep corners square (they're automatically rounded) and include padding so your logo doesn't touch the edges. Use JPEG or PNG format at 1200px by 1200px.

[Download image templates](https://shopify.dev/zip/SubmissionTemplates.zip)

See [App Store requirement 4.1](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#brand-your-app-uniquely-and-present-it-consistently-) for more information.

### B.​App store listing content

#### 1.​Feature media

A short video (2-3 minutes) is the best way to showcase your app's impact. Keep it promotional rather than instructional and limit screencasts to 25% of the video. If you don't have a video, use a static image that conveys your app's benefit or unique value.

When creating feature images (1600px by 900px, 16:9), keep them simple with one focal point, use solid backgrounds with good contrast (4.5:1 ratio recommended), and always include alt text. Don't use Shopify logos or repeat your app card subtitle in the image.

[Download image templates](https://shopify.dev/zip/SubmissionTemplates.zip)

Here are some examples of feature images:

#### Shopify Email

![The feature image for Shopify Email.](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/shopify-email-feature-image-FuuYDvWl.png)

#### Shopify Inbox

![The feature image for Shopify Inbox.](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/shopify-inbox-feature-image-8_JuypZk.png)

#### Shopify Local Delivery

![The feature image for Shopify Local Delivery.](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/local-delivery-feature-image-CNZWbTaz.png)

#### 2.​Demo store URL

Provide a link to a [development store](https://shopify.dev/docs/api/development-stores) that showcases your app. Link directly to the page that best demonstrates your app's functionality and add contextual instructions to guide merchants through the experience. A thoughtfully designed demo helps merchants visualize your app's value.

#### 3.​Screenshots

Screenshots should be 1600px by 900px (16:9). Include 3-6 desktop screenshots, including at least one of your app's UI. Ensure images are clear and focused on your app's functionality. Crop out browser chrome and sensitive information. Provide alt text, avoid PII, and don't include pricing, reviews, or outcome guarantees. If your app is mobile-responsive or works with POS, include screenshots showing those experiences.

#### 4.​App introduction

Your app introduction (100 characters) should clearly highlight the benefits merchants can expect. Tie your unique offering to measurable business outcomes. Avoid keyword stuffing, data claims, and incomplete sentences.

| Examples | Reason |
| - | - |
| * **Do**: We package and ship your orders. Fast, simple fulfillment can boost sales and delight customers.
* **Don't**: Get your products shipped fast. We'll take care of all the busy work for you. | Show specific benefits that drive value for merchants. Avoid generic marketing language. |
| - **Do**: Create print-on-demand custom puzzles. More customization options can help increase product sales.
- **Don't**: Custom puzzles. A creative solution to your print-on-demand needs. | Tie your unique app offering to a measurable business outcome. |
| * **Do**: Easily create personalized email campaigns. Buyer targeting can increase customer lifetime value.
* **Don't**: App Name is a best in class customer platform. Email marketing, text automation, Facebook custom audiences. | Show a clear merchant benefit and value proposition. Avoid unsubstantiated claims, keyword stuffing, and incomplete sentences. |

#### 5.​App details

In your app details (500 characters), describe functional elements and what makes your app unique. Avoid excessive marketing language, keyword stuffing, and outcome guarantees. Keep support info, links, and testimonials in their designated fields.

#### 6.​Feature list

Describe the functionality, not the technical mechanics. Keep features short and scannable (up to 80 characters per feature)—focus on what merchants care about, not how it's built.

| Examples | Reason |
| - | - |
| * **Do**: Reports that show you sales data in real time.
* **Don't**: Reports that use the latest push technology to offer you sales data with only 250ms of latency. | Describe functionality that is meaningful to merchants. Avoid focusing on the technical aspects of a feature. |
| - **Do**: Drag and drop page builder.
- **Don't**: Page builder built on the latest React Native technology to ensure the most efficient page building experience. | Be concise and informative. Avoid including feature mechanics that aren't relevant to merchants. |
| * **Do**: Customize details like shape and difficulty level in a full-screen experience.
* **Don't**: Print-on-demand, product customization, sales analytics, puzzles. | Describe a specific, unique feature. Avoid keyword stuffing and incomplete sentences. |

#### 7.​Integrations

List up to six integrations that merchants will be most interested in. Don't include Shopify itself, other shopping carts (unless you provide synchronization), or other Shopify apps (unless you directly integrate with them).

### C.​Pricing

Choose your primary billing method (Free to install, Recurring charge, or One-time payment) and provide clear pricing information in the designated section only. If you have paid plans, consider offering a free trial (we recommend 14 days). Plans display from lowest to highest price automatically.

For apps with free and paid plans, select **Recurring charge** and mark one plan as **Free**—this shows "Free plan available" in search results.

See [App Store requirement 4.2](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#keep-pricing-accurate-and-in-designated-areas) for more information.

Here's an example of how pricing details appear in your app listing:

#### Desktop view

![A desktop view of pricing details in an app listing](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/desktop-pricing-view-RhEBVlYC.png)

#### Mobile view

![A mobile view of pricing details in an app listing](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/mobile-pricing-view-ToVKZWNU.png)

| 1. | A link to a page that describes any charges that are billed outside of Shopify's Billing API. |
| - | - |
| 2. | The name of each pricing plan. |
| 3. | A free monthly plan. |
| 4. | The paid monthly plan price. |
| 5. | The discounted yearly price for a monthly plan. |
| 6. | A description of any additional charges for this plan. |
| 7. | A list of features for this plan. |
| 8. | A link to a page that describes the app's pricing in detail. |

### D.​Translate your app listing

Translated listings help your app reach a wider audience—they convert up to 4x better in non-English markets. List all languages your app's UI supports in your app store listing. To learn more about app translation, refer to [Internationalization](https://shopify.dev/docs/apps/build/localize-your-app).

English listings set as primary are automatically translated to:

* Brazilian Portuguese
* Danish
* Dutch
* French
* German
* Simplified Chinese
* Spanish
* Swedish

You can also add your own custom translations in the [Partner Dashboard](https://partners.shopify.com/organizations).

Note

Automated translation covers: App card subtitle, App introduction, App details, Features, Pricing details, Search terms, and image alt text. Adding a custom translation overwrites the automated one for that language.

Adding your own translated listing for an automatically translated language overwrites and disables automatic translation for that language. Deleting your translated listing resumes automated translation for that language.

To add a translated listing, go to **Apps** > your app > **Distribution** > **Manage listing** > **Add translated listing**. To delete a custom translation (which re-enables automation), use **More actions** > **Delete listing**.

### E.​App discovery

Choose accurate [categories and tags](https://shopify.dev/docs/apps/launch/app-store-review/app-listing-categories) that reflect your app's core functionality—this impacts discoverability. You can select up to 25 structured features per category to help merchants compare relevant app features.

If your app capabilities change and you want to change how your app is categorized, then you can submit an appeal to change the app categorization by using the link in the app submission form. After the Shopify app review team completes their review, they'll send a response, whether it's approved or rejected.

Include a privacy policy (required) and consider adding other helpful links to your developer website such as FAQ page, changelog, support portal, tutorial, and additional documentation. These resources help merchants understand and get the most value from your app. Link to dedicated pages rather than promotional landing pages or cloud documents.

Your app card subtitle should highlight benefits to merchants rather than just describing functions. For search terms, enter up to five relevant terms using complete words (not partial) and limit to one idea per term—for example, "email marketing" works, but "email marketing for leads" doesn't.

| Examples | Reason |
| - | - |
| * **Do**: Avoid lost sales by making pages load faster and improving SEO
* **Don't**: Boost Pagespeed in 1 click. Increase conversions, SEO & Sales. | Highlight the benefit to merchants instead of the function. Avoid incomplete sentences. |
| - **Do**: Pick products to sell from vetted manufacturers and suppliers
- **Don't**: Dropship via Wholesale Distributors, Manufacturers & Suppliers | Highlight the benefit to merchants instead of the function. |
| * **Do**: Control which customers access different parts of your store
* **Don't**: Access control, for anything in your online store :) | Highlight the benefit to merchants instead of the name of the feature. |

Optimize your title tag and meta description for search engines. Follow [Google's title tag best practices](https://developers.google.com/search/docs/advanced/appearance/title-link) and [write effective meta descriptions](https://www.shopify.com/blog/how-to-write-meta-descriptions) to improve click-through rates from search results.

![A screen capture of Google search results, showing the title tag with the meta description below it.](https://shopify.dev/assets/assets/images/api/listing-in-the-app-store/search-engine-example-Cl8IC9BU.png)

### F.​Merchant install eligibility

Set install eligibility criteria in the app submission form to reduce uninstalls and negative reviews from ineligible merchants. Specify which sales channels your app needs (Online Store or POS) and geography criteria (country, shipping, currency) to target the right merchants. If a merchant changes their store settings after installation, use endpoints and webhooks to detect changes and notify them.

See [App Store requirement 4.3](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#provide-accurate-and-truthful-listing-information) for more information.

### G.​App review preparation

Provide clear instructions and a complete screencast showing your app's setup process and functionality. If your app integrates with third-party platforms, include valid test credentials that grant full access. Make screencasts in English or with English subtitles, and demonstrate the expected outcome for each test case.

See [App Store requirement 4.5](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#ensure-your-submission-is-complete-and-accurate) for more information.

***

## 6.​Security and merchant risk

Before you submit your app, make sure it's secure so the merchants who use it won't be at risk. See [App Store requirements section 3](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#security) for more information.

***

## 7.​Data and user privacy

Merchants trust you with their customers' sensitive data. Proper data handling protects merchants from privacy violations, legal liability, and loss of customer trust. Include a privacy policy in your listing to build transparency and confidence with merchants.

See [App Store requirements section 3](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#security) for more information.

Tip

Your app should use supported APIs only—apps using APIs that will be deprecated within 90 days can't be submitted. Review [API versioning policies](https://shopify.dev/docs/api/usage/versioning) for details.

***

## 8.​Support

Strong support helps merchants succeed with your app and reduces negative reviews from frustrated users. Provide clear, Shopify-specific instructions in your help documentation and in-app context so merchants can quickly resolve issues themselves. Refer to Polaris [Help documentation](https://polaris.shopify.com/content/help-documentation) guidelines for writing effective support content. Keep your [emergency developer contact information](https://shopify.dev/docs/api/usage/versioning/updates#update-your-developer-contact-details) up to date in your Partner Dashboard.

See [App Store requirement 4.5](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#ensure-your-submission-is-complete-and-accurate) for more information.

***

## Category-specific best practices

Certain app types have unique impacts on merchant operations and require different APIs, extensions, and implementations. These category-specific best practices ensure these apps properly serve their use cases. Note that some apps may fall into multiple categories. For example, an app could be both a product sourcing and online store app.

***

## 9.​Online store

Online store apps help merchants customize their storefront experience. Proper implementation ensures your app integrates seamlessly without breaking themes or requiring manual code changes.

Use [theme app extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions) to modify merchant themes—avoid requiring manual code changes. For vintage theme support, provide clear instructions for manual integration. Use [app proxies](https://shopify.dev/docs/apps/build/online-store/display-dynamic-data) to forward requests and display data.

Ensure your app works properly in both the Theme Editor and [theme editor environment](https://shopify.dev/docs/storefronts/themes/tools/online-editor), and provide [detailed setup instructions](https://shopify.dev/docs/apps/online-store/theme-app-extensions/ux-guidelines#onboarding-for-app-embed-blocks) with [deep links](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/configuration#deep-linking). Keep app branding minimal—use standard attribution (24x24 pixels) unless customers directly interact with branded elements as part of their experience (like payment methods or loyalty programs). Let merchants preview edits before publishing storefront changes.

#### App Name Branding

App Name Branding in storefront visual components is permitted only in the following cases:

* Your app may use App Name Branding in theme extensions only if one or both criteria are met:

  1. Customers directly interact with the custom branding elements as a key aspect of their buying experience, for example as part of a payment method or loyalty program.
  2. Removing the custom branding elements would cause confusion or harm to customers.

* If apps want to use App Name Branding but do not meet both criteria above, the app must use the standard app attribution pattern. Regardless, no app is permitted to do the following:

  * Requesting app reviews or ratings
  * Promoting other apps or services

App Name Branding includes:

* Company or app logos, icons, branded watermarks, visual identifiers, or other branded imagery.
* Company or app name displayed as text in any form, including plain text, branded fonts, or stylized lettering.
* Custom design elements that contain the name or logo of the company or app.

Standard app attribution: Limited to a 24x24 pixel width and height on any image or text.

See [App Store requirement 5.1](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#online-store) for more information.

***

## 10.​Embedded apps

Embedded apps provide a seamless experience by integrating directly into the Shopify admin and POS, helping merchants work efficiently without switching contexts.

Use [Shopify App Bridge](https://shopify.dev/docs/api/app-bridge) to ensure OAuth redirects to your embedded app, and provide a consistent embedded experience by integrating off-platform features into the Shopify admin. Use session tokens for authentication and avoid third-party cookies or local storage, as they may not work in all browsers. Ensure your app functions in Chrome's incognito mode.

If using max modal (full screen mode), launch it only from merchant interactions (not from the navigation menu) and use it for complex editors or workflows where it improves the user experience. For POS-embedded apps, ensure all POS actions are complete and your UI is accessible from the POS Apps Admin Dashboard.

See [App Store requirement 2.2](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#use-shopifys-apis-and-platform-tools) for more information.

***

## 11.​Product sourcing

Product sourcing apps help merchants discover and sell products from suppliers. Proper payment handling and fulfillment workflows protect both you and merchants from fraud and financial risk.

Use a PCI-compliant gateway for goods sold to merchants, but charge other app costs through the [Billing API](https://shopify.dev/docs/apps/launch/billing). Don't automatically fulfill orders in pending payment state—this protects you from fraud risk. Add cost of goods to the Cost field in the merchant's product page, and avoid selling high-risk products that violate Shopify's [Acceptable Use Policy](https://www.shopify.com/legal/aup). Use the [`fulfillmentOrderSubmitFulfillmentRequest`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentOrderSubmitFulfillmentRequest) mutation for fulfillment requests.

See [App Store requirement 5.5](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#product-sourcing) for more information.

***

## 12.​Mobile app builders

Mobile app builders empower merchants to create mobile apps for their stores. Security is critical—improper API handling exposes merchants to data breaches and compromised customer information.

Convert your mobile app builder into a Sales Channel to enable checkout creation. Provide either a customizable theme builder or preset themes, and include detailed instructions for creating developer accounts and submitting to the Apple App Store or Google Play. Apps built by your builder should not make direct requests to the authenticated GraphQL Admin API—store client secrets and access tokens on a secure web server, not on mobile devices.

See [App Store requirement 5.9](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#mobile-app-builders) for more information.

***

## 13.​Sales channels

Sales channels help merchants expand their reach by publishing products to additional platforms. A well-built sales channel provides clear account management, accurate product syncing, and reliable checkout flows.

Build your sales channel using [Polaris components](https://polaris.shopify.com/getting-started) and [cart permalinks](https://shopify.dev/docs/apps/build/checkout/create-cart-permalinks) that take customers directly to Shopify's checkout. After OAuth installation, redirect merchants to the [account connection](https://polaris.shopify.com/components/actions/account-connection) component and allow them to connect and disconnect their account. Use [banner](https://polaris.shopify.com/components/feedback-indicators/banner) components to communicate approval status.

In your publishing section, show the number of published products with links to the bulk editor, and use the [ProductListing](https://shopify.dev/docs/api/admin-rest/latest/resources/productlisting) resource to retrieve products. Communicate product issues using [ResourceFeedback](https://shopify.dev/docs/api/admin-rest/latest/resources/resourcefeedback) and banner components. Include a [help footer](https://polaris.shopify.com/components/navigation/footer-help) on every page linking to your support resources.

For sales attribution, use a storefront access token. Refer to [Building Shopify channels](https://shopify.dev/docs/apps/build/sales-channels) for the complete lifecycle diagram.

See [App Store requirement 5.7](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#sales-channel) for more information.

***

## 14.​Purchase option apps

Purchase option apps let merchants offer subscriptions, pre-orders, and other flexible buying options. Clear pricing transparency and functional customer portals help reduce cancellations and support requests.

**Storefront implementation:** Ensure your customer flow works properly on desktop and mobile across [all supported browsers](https://shopify.dev/docs/storefronts/themes/store/requirements). Automate theme modifications and support [multi-currency](https://shopify.dev/docs/api/admin-rest/latest/resources/transaction) with correct [currency and price rounding rules](https://shopify.dev/docs/storefronts/themes/pricing-payments/subscriptions/subscription-ux-guidelines#considerations-for-currency-switching-and-price-rounding). Assign the correct [purchase option category](https://shopify.dev/docs/apps/build/purchase-options#selling-plans-category) for each selling plan.

Display pricing clearly and show when customers will be charged. Use standalone widgets following the [subscription UX guidelines](https://shopify.dev/docs/storefronts/themes/pricing-payments/subscriptions/subscription-ux-guidelines#inline-pricing) and [deferred purchase option UX guidelines](https://shopify.dev/docs/storefronts/themes/pricing-payments/preorder-tbyb/preorder-tbyb-ux-guidelines#product-forms). In cart pages, display the [selling plan name](https://shopify.dev/docs/api/liquid/objects/selling_plan#selling_plan-name)—but check if the theme already includes it first.

Tip

Shopify Theme Store [requires](https://shopify.dev/docs/storefronts/themes/store/requirements#4-features) themes to [display the selling plan name in the cart](https://shopify.dev/docs/storefronts/themes/pricing-payments/subscriptions/add-subscriptions-to-your-theme#the-selling-plan-display-in-the-cart). Check if `selling_plan.name` already exists in the theme's `cart.liquid` file before adding it.

**Customer portal:** Provide a [customer portal](https://shopify.dev/docs/apps/build/purchase-options/customer-portal) accessible from the order status page and post-purchase emails. The portal should display all subscriptions with details (products, delivery frequency, price, schedule) and let customers cancel subscriptions or modify [payment methods](https://shopify.dev/docs/api/admin-graphql/latest/objects/customerpaymentmethod).

**Shopify admin integration:** Use [app extensions](https://shopify.dev/docs/apps/build/purchase-options/product-subscription-app-extensions) on product pages in the Shopify admin, and ensure changes sync between the admin and your app. Include direct links to [orders](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract#order-page-in-the-shopify-admin) and [customers](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract#customers-page-in-the-shopify-admin) in the admin.

See [App Store requirement 5.4](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#purchase-option) for more information.

***

## 15.​Donation distribution apps

Donation apps help merchants support charitable causes. Transparency about charitable status and fund distribution builds trust with both merchants and their customers.

Use the [Billing API](https://shopify.dev/docs/apps/launch/billing/support-one-time-purchases) or a PCI-compliant gateway for donations. Provide proof of charitable status in your UI and show merchants proof that funds reach registered charities (not tax receipts). Collect customer donations only through Shopify checkout using [Theme App Extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions) or [Checkout UI Extensions](https://shopify.dev/docs/api/checkout-ui-extensions), and include [instructions for hiding add-to-cart buttons](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/hide-add-to-cart-buttons) on donation products. Clearly indicate operating costs in your UI and listing.

See [App Store requirement 5.10](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#donation) for more information.

***

## 16.​Payments apps

Payments apps process financial transactions for merchants. Proper implementation ensures secure payment handling, protects merchants from fraud, and maintains checkout performance.

**General practices:** Your payments app should meet the [minimum product requirements](https://shopify.dev/docs/apps/build/payments/requirements) and use only the [Payments Apps API](https://shopify.dev/docs/api/payments-apps). Submit screencasts for all [supported browsers](https://help.shopify.com/en/manual/shopify-admin/supported-browsers) showing your payment flow. Allow buyers to cancel payments and [redirect properly](https://shopify.dev/docs/apps/build/payments/offsite/use-the-cli) between checkout, your payment flow, and the order confirmation page. Present identical payment information to what's shown at checkout, and don't upsell products in the payment flow.

**Naming and UI:** Name your payments app using your legal business name without marketing text—merchants discover payment apps by the payment methods offered, not by name. If using [checkout UI extensions](https://shopify.dev/docs/apps/build/payments/credit-card/with-extensibility), avoid banners, logos, or graphics as decorative elements, and use only permitted targets.

**Testing:** Provide a test store, credentials, payment/refund instructions, and descriptions of specific scenarios (installments, 3D Secure). Refer to [Prohibited actions](https://shopify.dev/docs/apps/build/payments/requirements#prohibited-actions) for a complete list of restrictions.

**Cryptocurrency payments apps** must be accepted into the blockchain app program—contact [Partner Support](https://partners.shopify.com/current/support/) to apply. Implement KYC requirements, transaction monitoring, sanctions screenings, and wallet risk assessments. Use IP blocking for restricted jurisdictions and monitor regulatory guidance to avoid supporting tokens that constitute securities.

See [App Store requirement 5.2](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#payment) for more information.

***

## 17.​Post Purchase apps

Post-purchase apps help merchants increase order value through upsells after checkout. Transparent pricing and clear buyer consent protect merchants from chargebacks and customer complaints.

Redirect customers to the order confirmation page after they respond to post-purchase requests. Limit consecutive requests to 3 and ensure customers can accept or decline offers. Make upsell offers transparent with accurate pricing that dynamically updates when customers adjust quantity or variants. Display the same product price as in the merchant's store and use the [checkout calloutbanner](https://shopify.dev/api/checkout-extensions/components/calloutbanner) for limited-time offer details. Don't display order tracking, status functionality, or third-party promotions.

See [App Store requirement 5.8](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#post-purchase) for more information.

***

## 18.​Checkout apps

Checkout apps enable merchants to customize the checkout experience. Proper implementation maintains checkout performance and protects buyers from deceptive practices that could damage merchant reputation.

Note

Checkout apps and extensions have [design requirements](https://shopify.dev/docs/apps/launch/app-requirements-checklist#design-requirements-for-checkout-apps) that apply to custom apps as well as public apps. Be sure that your app meets [all requirements](https://shopify.dev/docs/apps/launch/app-requirements-checklist) for its functionality and distribution type.

Use only [documented APIs](https://shopify.dev/docs/api/checkout-ui-extensions/latest/apis/extensiontargets) for customizing checkout. Don't request payment information, add countdown timers, or collect information already captured by standard checkout fields. For network access, keep response times under one second and render [skeleton components](https://shopify.dev/docs/api/checkout-ui-extensions/latest/components) initially to avoid blocking checkout. Extensions should be feature-complete, provide novel functionality, and avoid self-promotion.

### Design guidelines

All apps that extend Shopify checkout—both public and custom—should follow these design guidelines. These guidelines ensure buyers receive the lowest checkout total by default, that all additional charges are clearly disclosed, and buyers give explicit consent to any optional charges.

Avoid deceptive "dark patterns" that damage buyer trust—they deceive buyers and damage trust in merchants, Shopify, and the entire commerce ecosystem. The following examples demonstrate key principles you can apply in your own designs.

See [App Store requirement 5.6](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#checkout-customization) for more information.

#### Optional charges must be off by default

If your app adds optional charges to the storefront or checkout, those charges should be turned off by default. The following example shows an app extension that adds a premium shipping option at checkout.

This design is acceptable because buyers can clearly see the optional charge and actively choose to opt in by checking a box:

![Shopify Checkout extension with optional extra charge inactive by default](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/checkout-extra-charge-acceptable-CN-0-nFN.png)

However, this design pattern is unacceptable because it automatically adds an optional item to the cart, tries to hide the charge by calling it a "gift," and forces buyers to opt out:

![Shopify Checkout extension with an optional extra charge disguised as an opt-out 'gift' included with purchase](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/checkout-extra-charge-unacceptable-QQE1zFwC.png)

#### Optional charges must be clearly disclosed and itemized

If your app adds optional charges to the storefront or checkout, those charges should be itemized so buyers can clearly see them. Simply showing a higher total checkout price isn't enough disclosure. Make sure all optional charges are clearly itemized on the storefront, in the cart, and at checkout.

For example, this cart drawer shows two checkout buttons: one with an optional shipping protection fee and one without. This design is acceptable because the optional fee is clearly itemized and buyers can easily see the additional cost and choose whether to pay it:

![Cart with two clearly labeled checkout options, one disclosing an itemized extra charge](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/cart-charge-acceptable-D72sasab.png)

However, the following example is unacceptable. While the optional charge is disclosed, it's unclear which checkout button adds the fee and whether the shipping protection fee is already included in the cart total or will be added later at checkout:

![Cart with a confusing disclosure about an optional extra charge](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/cart-charge-unacceptable-tn2gsqtL.png)

This standard applies throughout the storefront, cart, and checkout. For example, this product page has two **Add to Cart** buttons—one clearly shows an optional extra charge. This pattern is acceptable:

![Product page with two clearly labeled Add to Cart buttons, one disclosing an itemized extra charge](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/product-page-acceptable-BzUXdkXn.png)

This product page is unacceptable because the primary **Add to Cart** button hides an extra charge within the quoted total price and obscures the option to add the product at its actual display price:

![Product page with a misleadingly labeled Add to Cart button](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/product-page-unacceptable-5am7gpeN.png)

#### Shipping must default to the lowest-priced option

When multiple shipping options are available at different prices, the cheapest option must be selected by default.

This example is unacceptable because it places the most expensive shipping option first and makes it the default:

![Checkout where shipping options have been manipulated to default to a higher-priced shipping option](https://shopify.dev/assets/assets/apps/checkout/app-ui-requirements/checkout-shipping-unacceptable-Cj8O4uKC.png)

***

## 19.​Blockchain apps

Blockchain apps enable merchants to sell NFTs and use tokengating. Proper data privacy and regulatory compliance protect merchants from legal risks and regulatory violations.

Ensure no personal data is written or stored on-chain. Support only primary NFT sales on Shopify—secondary sales should occur on third-party platforms. Don't facilitate NFTs that could be classified as securities or have transferrable royalties.

Caution

Royalties should never be dispersed to buyers or recipients of NFTs.

**NFT distribution apps** should identify NFT variants by [populating product metafields](https://shopify.dev/docs/apps/build/blockchain/nft-distribution#nft-distribution-product-metafields-requirements) and write blockchain transaction IDs to fulfillment tracking fields. Provide wallet acquisition options for customers and ensure they can receive full self-custody without post-purchase fees (unless using permissioned blockchains—disclose this before purchase). Block NFT features while Shopify Payments is active until shops are approved using the [NFT Sales Eligibility API](https://shopify.dev/docs/apps/build/blockchain/nft-distribution/check-nft-sales-eligibility).

**Tokengating apps** should identify gated orders using [order metafields](https://shopify.dev/docs/apps/build/blockchain/tokengating#tokengating-order-metafields) and gated products using [product metafields](https://shopify.dev/docs/apps/build/blockchain/tokengating#tokengating-product-metafields).

See [App Store requirement 5.11](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements#blockchain) for more information.

***

## Next steps

* [**Review the App Store requirements**](https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements) - Review the App Store requirements before submitting your app for review.
* [**Prepare your app before submitting**](https://shopify.dev/docs/apps/launch/app-store-review/pass-app-review) - Learn our recommended best practices for preparing and testing your app before submitting it for review.

***

* [General best practices for all apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#general-best-practices-for-all-apps)
* [1.​Prohibited and restricted app configurations](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#1-prohibited-and-restricted-app-configurations)
* [2.​Installation and setup](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#2-installation-and-setup)
* [3.​Functionality and quality](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#3-functionality-and-quality)
* [4.​App performance](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#4-app-performance)
* [5.​App listing](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#5-app-listing)
* [6.​Security and merchant risk](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#6-security-and-merchant-risk)
* [7.​Data and user privacy](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#7-data-and-user-privacy)
* [8.​Support](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#8-support)
* [Category-specific best practices](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#category-specific-best-practices)
* [9.​Online store](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#9-online-store)
* [10.​Embedded apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#10-embedded-apps)
* [11.​Product sourcing](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#11-product-sourcing)
* [12.​Mobile app builders](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#12-mobile-app-builders)
* [13.​Sales channels](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#13-sales-channels)
* [14.​Purchase option apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#14-purchase-option-apps)
* [15.​Donation distribution apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#15-donation-distribution-apps)
* [16.​Payments apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#16-payments-apps)
* [17.​Post Purchase apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#17-post-purchase-apps)
* [18.​Checkout apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#18-checkout-apps)
* [19.​Blockchain apps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#19-blockchain-apps)
* [Next steps](https://shopify.dev/docs/apps/launch/shopify-app-store/best-practices.md#next-steps)