{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"3c557a89009e98070e56903177d4b703481873ce2cc805266ff6a161486830f1","entry":{"id":"shopify/partner-app","name":"Shopify Partner account and app (custom or App Store)","vendor":"Shopify","summary":"A Shopify Partner organization, an app created with Shopify CLI or the Dev Dashboard (client ID and secret), a permanent choice of distribution (custom or public), and for public apps the $19 App Store registration, protected customer data request, compliance webhooks and App Store review.","aliases":["shopify","shopify-app","shopify-app-store"],"category":"commerce","group":"B","homepage":"https://www.shopify.com/partners","docs":["https://shopify.dev/docs/apps/build/dev-dashboard","https://shopify.dev/docs/apps/launch/distribution","https://shopify.dev/docs/apps/launch/app-store-review/submit-app-for-review","https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"dev-dashboard","url":"https://shopify.dev/docs/apps/build/dev-dashboard","title":"Shopify Dev Dashboard","accessed":"2026-10-25","supports":"Apps are created with Shopify CLI (recommended for extensible apps) or in the Dev Dashboard (API-only apps); all apps in an organization appear in one list; client ID and secret live in the Dev Dashboard, not in shopify.app.toml; releasing a version equals shopify app release.","kind":"official"},{"id":"distribution","url":"https://shopify.dev/docs/apps/launch/distribution","title":"Select a distribution method (shopify.dev)","accessed":"2026-10-25","supports":"Public (App Store, needs Shopify approval), custom (one merchant, single store or one Plus organization, no approval, cannot use Shopify billing), admin-created (legacy, unavailable for new apps); the distribution method cannot be changed after selection.","kind":"official"},{"id":"submit","url":"https://shopify.dev/docs/apps/launch/app-store-review/submit-app-for-review","title":"Submit your app for review (shopify.dev)","accessed":"2026-10-25","supports":"Submission prerequisites - app URLs without \"Shopify\" or \"Example\", compliance webhooks, 1200x1200 JPEG/PNG icon, API contact email, emergency email and phone, at least one listing, protected customer data request or opt-out (not possible while under review), passing automated checks; temporary suspensions for repeated unaddressed issues or ignored review emails.","kind":"official"},{"id":"review-process","url":"https://shopify.dev/docs/apps/launch/app-store-review/review-process","title":"App review process (shopify.dev)","accessed":"2026-10-25","supports":"Review states Draft, Submitted, Paused (core requirements fail), Reviewed (fixes to discuss with reviewer), Published; \"Submit fixes\" from the status banner.","kind":"official"},{"id":"revenue-share","url":"https://shopify.dev/docs/apps/launch/distribution/revenue-share","title":"Revenue share for Shopify App Store developers","accessed":"2026-10-25","supports":"One-time $19 USD App Store registration per Partner account; 0% on first $1,000,000 USD lifetime gross app revenue earned on or after 1 January 2025 and 15% above it; 15% on all revenue for developers above $20M prior-year App Store earnings or $100M company revenue; 2.9% processing fee; Associated Developer Accounts must be linked.","kind":"official"},{"id":"protected-data","url":"https://shopify.dev/docs/apps/launch/protected-customer-data","title":"Work with protected customer data (shopify.dev)","accessed":"2026-10-25","supports":"Levels 0-2 of protected customer data; request via Partner Dashboard API access requests after choosing distribution; Level 1 has nine requirements and Level 2 seven more; data protection reviews may be requested; development-store-only apps need no review.","kind":"official"},{"id":"requirements","url":"https://shopify.dev/docs/apps/launch/shopify-app-store/app-store-requirements","title":"Shopify App Store requirements","accessed":"2026-10-25","supports":"Must use Shopify App Pricing or the Billing API for all charges, off-platform billing not distributable; session tokens; OAuth immediately after install; prohibited app types (agency matching, classifieds, lending, non-Shopify POS, desktop-app-dependent); no identical apps.","kind":"official"},{"id":"privacy-webhooks","url":"https://shopify.dev/docs/apps/build/compliance/privacy-law-compliance","title":"Privacy law compliance - mandatory compliance webhooks (shopify.dev)","accessed":"2026-10-25","supports":"App Store apps must subscribe to customers/data_request, customers/redact and shop/redact, return 200-series, and complete actions within 30 days.","kind":"official"},{"id":"partner-terms","url":"https://www.shopify.com/partners/terms","title":"Shopify Partner Program Agreement (last updated 27 February 2026)","accessed":"2026-10-25","supports":"Shopify may suspend partner privileges or terminate the Partner Account without notice; no fake or incentivised reviews; must use the Shopify Billing resource; one user per Partner Account login; no multiple apps with substantially the same services.","kind":"official"},{"id":"community-review-time-1","url":"https://community.shopify.dev/t/shopify-app-review-still-assigning-a-reviewer-after-5-days-how-long-does-it-take/36879","title":"Shopify App Review still \"Assigning a Reviewer\" after 5 days (Shopify developer community)","accessed":"2026-10-25","supports":"Developers report review taking usually 1-3 weeks.","kind":"community"},{"id":"community-review-time-2","url":"https://community.shopify.com/t/how-long-does-it-take-for-an-app-review-to-be-completed/264027","title":"How long does it take for an app review to be completed? (Shopify Community)","accessed":"2026-10-25","supports":"A Shopify staff reply says reviews typically take 5-10 business days, sometimes longer with queue volume; contact Partner support after 30 days.","kind":"community"}],"allowed_domains":["shopify.com","shopify.dev"],"account_model":{"summary":"A person's Shopify login joins a Partner organization; apps belong to the organization and are managed in the Dev Dashboard (and Partner Dashboard for App Store listing, payouts and API access requests). Apps are installed on development stores for testing and on merchant stores in production.","accounts":[{"name":"Shopify login (user)","kind":"personal","owned_by":"the person","required":true,"note":"The Partner Agreement says each Partner Account login should belong to a single user."},{"name":"Partner organization","kind":"organisation","owned_by":"the developer business","parent":"Shopify login (user)","required":true,"note":"Pays the one-time $19 App Store registration if publishing publicly; receives payouts."},{"name":"App","kind":"project","parent":"Partner organization","required":true,"note":"Has a client ID and secret; distribution (public or custom) is chosen once and cannot be changed."},{"name":"Development store","kind":"other","parent":"Partner organization","required":false,"note":"Free test store for installing and testing the app."}],"notes":["Keep separate development and production apps; pick distribution on the production app.","Custom-distribution apps need no review but cannot charge through Shopify billing."]},"have_ready":[{"kind":"domain_email","description":"Business email for the Partner account and the app submission contact","why":"Shopify sends all review emails to the contact address on the listing form; ignoring them can lead to suspension.","needed_for":["partner-account","submit-review"],"auto_check":"domain_email_mx","source":"submit"},{"kind":"phone_for_2fa","description":"Emergency contact phone number (and email) for critical technical issues","needed_for":["submit-review"],"auto_check":"none","source":"submit"},{"kind":"app_icon","description":"App icon 1200 x 1200 px, JPEG or PNG","needed_for":["submit-review"],"auto_check":"none","source":"submit"},{"kind":"live_website","description":"Production app URL and redirect URLs on your own domain (must not contain \"Shopify\" or \"Example\")","needed_for":["submit-review"],"auto_check":"website_live","source":"submit"},{"kind":"app_privacy_policy_url","description":"Privacy policy and data protection details covering how the app handles merchant and customer data","why":"Required to request protected customer data (Level 1 has nine requirements, Level 2 seven more).","needed_for":["protected-data"],"auto_check":"none","source":"protected-data"},{"kind":"payment_card","description":"Card for the one-time $19 USD App Store registration (public apps only)","needed_for":["app-store-registration"],"auto_check":"none","source":"revenue-share"},{"kind":"other","description":"App Store listing content (description, screenshots, pricing) in at least one primary language","needed_for":["submit-review"],"auto_check":"none","source":"submit"}],"steps":[{"id":"partner-account","title":"Create a Shopify Partner account","summary":"Sign up for the Shopify Partner Program yourself and accept the Partner Program Agreement.","route":"guided","depends_on":[],"gate":"human_terms","url":"https://www.shopify.com/partners","sources":["partner-terms"]},{"id":"create-app","title":"Create the app (Shopify CLI or Dev Dashboard)","summary":"Run `shopify app init` with Shopify CLI, or create an API-only app in the Dev Dashboard. The client ID and secret appear in the Dev Dashboard; verapli captures the secret by selector.","route":"guided","depends_on":["partner-account"],"gate":"human_submit","url":"https://dev.shopify.com/dashboard","capture":{"env":"SHOPIFY_API_SECRET","kind":"secret"},"sources":["dev-dashboard"]},{"id":"choose-distribution","title":"Choose distribution (permanent)","summary":"Pick Public (Shopify App Store, needs review, can use Shopify billing) or Custom (one merchant or one Plus organization, no review, no Shopify billing). This cannot be changed later.","route":"guided","depends_on":["create-app"],"gate":"human_submit","recovery":[{"hiccup":"You chose the wrong distribution.","fix":"It cannot be changed; create a new app with the correct distribution.","source":"distribution"}],"sources":["distribution"]},{"id":"app-store-registration","title":"Register for the Shopify App Store ($19 one-time)","summary":"Pay the one-time $19 USD registration for the Partner account and link all Associated Developer Accounts. You enter payment details yourself.","route":"guided","depends_on":["choose-distribution"],"gate":"human_payment","optional":true,"sources":["revenue-share"]},{"id":"protected-data","title":"Request protected customer data access (or opt out)","summary":"In the Partner Dashboard, open the app's API access requests, request only the customer data and fields you need with reasons, and complete the data protection details. Cannot be done while the app is under review.","route":"guided","depends_on":["choose-distribution"],"gate":"human_submit","recovery":[{"hiccup":"Protected data access is not approved.","fix":"Request only the minimum fields the feature needs; handle errors or redacted data in the app.","source":"protected-data"}],"sources":["protected-data","submit"]},{"id":"compliance-webhooks","title":"Subscribe to the mandatory compliance webhooks","summary":"Subscribe to customers/data_request, customers/redact and shop/redact, return a 200-series status and complete actions within 30 days.","route":"api","depends_on":["create-app"],"gate":"none","sources":["privacy-webhooks"]},{"id":"submit-review","title":"Submit the app for App Store review","summary":"Configure URLs, icon, contact and emergency details, create the listing, pass the automated checks, then submit. The person presses submit and answers reviewer emails.","route":"guided","depends_on":["app-store-registration","protected-data","compliance-webhooks"],"gate":"third_party_review","lead_time":{"reported":{"text":"A Shopify staff forum reply says reviews typically take 5-10 business days and can be longer with queue volume; developers report 1-3 weeks, sometimes much longer after repeated rejections.","source":"community-review-time-2"}},"recovery":[{"hiccup":"App moves to Paused.","fix":"Core requirements prevent review; make the changes in the email and use \"Submit fixes\" in the status banner.","source":"review-process"},{"hiccup":"App moves to Reviewed.","fix":"Reply to the reviewer's email to continue.","source":"review-process"},{"hiccup":"App is Suspended from review.","fix":"Repeatedly unaddressed issues or ignored emails cause temporary suspension; resubmit on the date shown in the banner, and fix everything first since repeat suspensions get longer.","source":"submit"},{"hiccup":"Automated checks fail.","fix":"Fix the reported issues and rerun the checks before submitting.","source":"submit"}]}],"outputs":[{"name":"SHOPIFY_API_KEY","description":"App client ID","secret":false,"from_step":"create-app"},{"name":"SHOPIFY_API_SECRET","description":"App client secret","secret":true,"from_step":"create-app"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Partner account can be terminated without notice","text":"Shopify may suspend partner privileges or terminate the Partner Account entirely without notice for breaches of the Partner Program Agreement.","source":"partner-terms"},{"kind":"rules_say","severity":"red","title":"No fake or incentivised reviews","text":"You must not solicit or permit fake, misleading or incentivised app reviews.","source":"partner-terms"},{"kind":"rules_say","severity":"red","title":"Billing must go through Shopify","text":"Public apps must charge through Shopify App Pricing or the Billing API; apps with off-platform billing cannot be distributed on the App Store.","source":"requirements"},{"kind":"rules_say","severity":"amber","title":"No duplicate apps","text":"Do not publish multiple apps offering substantially the same service or identical to your other apps.","source":"partner-terms"},{"kind":"rules_say","severity":"amber","title":"Distribution is permanent","text":"The distribution method cannot be changed after you pick it.","source":"distribution"},{"kind":"people_report","severity":"yellow","title":"Review can take weeks","text":"Developers report first reviews taking 1-3 weeks or longer in busy periods; plan launches around it.","source":"community-review-time-1"}],"pricing_notes":{"free_tier":"Partner account, development stores and custom apps are free.","costs":"One-time $19 USD App Store registration; 0% revenue share on the first $1M USD lifetime gross app revenue (from 1 Jan 2025), 15% above; 2.9% processing fee on billing.","source":"revenue-share"},"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"Shopify CLI creates and deploys app configuration (shopify app init / deploy / release); Partner signup, distribution choice, registration, data requests and review submission are human dashboard steps.","docs":["https://shopify.dev/docs/apps/build/dev-dashboard"],"source":"dev-dashboard"},"detect":{"env_names":["SHOPIFY_API_KEY","SHOPIFY_API_SECRET"],"packages":["@shopify/shopify-app-remix","@shopify/shopify-api","@shopify/app-bridge-react","@shopify/cli"],"config_keys":["shopify.app.toml"]}}}