Shopify Plus: one custom app across multiple stores in an organization
Short answer: yes, one custom app can be installed on every store in a single Shopify Plus organization. If a partner builds it, select Custom distribution, enter one store's domain, leave Allow multi-store installs for one Plus organization checked, and send the install link. If the merchant builds it in its own organization's Dev Dashboard, there is no distribution step at all: the app installs from its Installs card on stores in that organization. Either way the boundary is the organization. Stores that belong to a different merchant or a different organization need their own app.
If that describes your situation, this page is all you need. No extra tooling is required.
Which stores can share one custom app?
The stores of one merchant, inside one organization. Shopify's distribution page says a custom-distribution app is "Installed on a single Shopify store, on multiple stores that belong to the same Plus organization, or on development stores." Shopify's API Terms draw the same line from the other side: a Custom Application "may not be installed by more than one Merchant", and "a Merchant may have more than one Merchant Store."
A note on the word "organization". Shopify's Help Center says stores on the Plus plan have organization features by default, and that Plus organizations use a structure called expansion stores. Merchants on other plans can also group stores into an organization, if one owner owns every store and they share a billing currency. Shopify's custom-distribution docs name Plus organizations specifically, and don't say non-Plus organizations qualify for the multi-store option. Don't assume they do.
Who builds the app: the merchant or a partner?
This decides the steps, so settle it first. Shopify treats the two cases differently: "The Distribution card appears only for apps that belong to a Partner organization. If you created the app in your store's organization, then install it from the app's Installs card instead" (Select a distribution method).
| Merchant builds it in its own organization | Partner builds it in the partner's organization | |
|---|---|---|
| Where it's created | Dev Dashboard, opened from the Shopify admin | The partner's Dev Dashboard |
| Distribution step | None. Install from the Installs card | Select Custom distribution, generate an install link |
| Which stores | Other stores in the same organization | Stores in the same Plus organization |
| How the backend gets a token | Client credentials grant, per store | Token exchange or the authorization code grant, per store |
| Who can build it | Users with the App developer role, or a Plus custom role with Build and manage apps | The partner organization's app developers |
The token row is the one people miss. The client credentials grant "works only for stores in your organization, unless your app has public distribution and authenticates with a client assertion" (About app authentication). An app the merchant builds is in the stores' organization, so it qualifies. An app a partner builds sits in the partner's organization, so it doesn't, even when multi-store install is on. The client credentials guide covers the grant in full.
How does a partner enable multi-store install?
Shopify's steps, from Select a distribution method:
- Open the app in the Dev Dashboard. On the app's Home, find the Distribution card and click Select distribution method.
- Select Custom distribution and confirm. This is permanent: "You can't change the method after you select it."
- Enter one of the client's stores by its
myshopify.comoradmin.shopify.comdomain. - Leave Allow multi-store installs for one Plus organization checked. Shopify's steps describe clearing it only "to limit your app to a single store."
- Click Generate link, copy the install link, and send it to the store owner.
Afterwards the same card links to Manage custom install link. If you keep separate development and production apps, Shopify says to select the distribution method on the production app (About app distribution).
Shopify's page doesn't spell out whether you reuse that one link for every store or generate one per store. In 2023 a developer quoted the link page as saying users "can install the app on any stores that belong to the same Plus organization as" a named store, and in his case the named store sat in his own test organization, not the client's (community thread, September 2023). That is an old report, not current documentation. Before you send the link, check which store and organization your own link page names.
What if the app was created before July 26, 2023?
It won't get the option by itself. Shopify's page: "If you created your custom app before July 26, 2023, then contact Shopify Support to enable multi-store installs." That is a support request, not a setting you can change.
How does a merchant install its own app on several stores?
The merchant route needs no Partner organization. Shopify's Dev Dashboard page says a merchant, or a developer building for the company's own stores, opens the Dev Dashboard from the Shopify admin, and "Apps that you create there are custom apps for your organization's stores." The steps, from the Help Center and Create apps using the Dev Dashboard:
- In the Shopify admin, go to Settings, Apps, click Develop apps, then Build apps in Dev Dashboard.
- Create the app, then create a version with the app URL, webhooks API version and access scopes, and Release it.
- In the app's Installs section, click Install app, select the store, and click Install. Repeat for each store, or share the install link with the other stores in the organization.
- For background work, get an Admin API token per store with the client credentials grant: the same client ID and secret, one request to each store's token endpoint. Tokens last 24 hours.
The Help Center states the limit in one line: "You can only install a custom app in other stores that are part of the same organization. You can't share apps to other merchants or even to other stores that are in a different organization." It does not mention Plus. Combined with non-Plus store grouping, that may cover non-Plus organizations too, but we have not seen Shopify say so, so test it on your own organization first.
A Shopify staff member described the same shape in April 2026 for stores in one Plus organization that "your organization owns": one custom app, installed on each store, and then "use the client credentials grant to get an access token per store" (Donal-Shopify, April 7, 2026).
What are the organization-boundary gotchas?
- A different organization means a different app. Developers report this error when they try: "This app can't be installed on this store. [App name] can only be installed on stores that are part of the same organization" (thread, February 2026). For a client store outside your organization, the fix is a custom-distribution install link, not a permission. The collaborator guide covers that case.
- The same owner is not the same organization. Shopify's client credentials troubleshooting warns: "Owning a store or having it installed doesn't automatically place it in your org." The store has to be in the organization.
- A partner-built app gets no client credentials on the merchant's stores. Multi-store install changes where the app can be installed, not which organization owns the stores. Plan for token exchange or the authorization code grant on each store.
- Scope changes are approved store by store. Shopify: "When you update scopes in a new version of your app, updates aren't applied automatically to the stores your app is installed on. Merchants still need to manually approve the new scopes in the Shopify admin." Ten stores means ten approvals.
- The distribution choice is permanent. If the app might later become a public product, that is a new app and a reinstall on every store. See limited visibility vs custom distribution.
- No Shopify billing. Custom distribution "Can't charge merchants through Shopify's app billing system" (About app distribution). You invoice the merchant directly.
- Several clients are several organizations. An agency's client list is not one organization, even if the agency manages every store. Each merchant needs its own app.
When is one app for the organization all you need?
- A brand with several storefronts in one Plus organization, such as regional or wholesale stores. One app, one configuration, one release, installed and approved store by store.
- An in-house team building for its own company's stores. The merchant route plus the client credentials grant, with no Partner organization.
- An agency building one app for one Plus client that runs several stores. One merchant, one app, multi-store install on.
You need one app per client store instead when the stores belong to different merchants or different organizations, or when a client's stores are not in a single Plus organization. Shopify staff prescribe that pattern for separate merchants in the same April 2026 thread: "you'd create one custom app per store in the Dev Dashboard", which "for a handful of stores" is "manageable". The full decision tree is in How to install a Shopify app on multiple stores.
Where DeploTeka fits (product note). If all your stores sit in one Plus organization, you don't need DeploTeka. One custom app with multi-store install, or an app the merchant builds in its own Dev Dashboard, is the whole answer. DeploTeka is for the other case: many client stores owned by different merchants. It creates a dedicated custom-distribution Shopify app per client store inside your own organization, seals the credentials and delivers them to your backend, and pauses with a named action when a step needs a person. It does not clone, build, or run your source on our servers, and the merchant still approves each install. Shopify requires that, and no tool removes it. deploteka.com
Sources: Shopify — Select a distribution method, Shopify — About app distribution, Shopify — Dev Dashboard, Shopify — Create apps using the Dev Dashboard, Shopify — User permissions, Shopify — About app authentication, Shopify — Authenticate an app for stores in your organization, Shopify Help Center — Installing and setting up apps, Shopify Help Center — Organization settings, Shopify Help Center — Group a store to an organization, Shopify API Terms. Community threads are linked as evidence of what was said in them, not as statements of Shopify policy. DeploTeka is independent software and is not affiliated with or endorsed by Shopify.