Getting Your Shopify App Approved: A Developer's Guide to App Store Review
We submitted 3 apps through the Shopify App Store review process. Here's what we learned about getting approved on the first attempt — and the mistakes that caused rejections.
The Shopify App Store review process is the final gate between your app and thousands of merchants. It's also one of the most opaque parts of the Shopify ecosystem — the guidelines are scattered across documentation, partner communications, and hard-won developer experience. After going through the process multiple times, here's our complete guide to getting your app approved.
What Shopify Reviews (And What They Don't)
Shopify's review focuses on four areas: (1) Functionality — does your app work as described? (2) Security — is merchant data handled safely? (3) Compliance — do you follow the API usage policies, billing rules, and GDPR requirements? (4) UX — does your app use Polaris correctly and provide a good merchant experience? They do NOT review your code quality, test coverage, or architecture decisions. The review is entirely from the merchant's perspective.
The Most Common Rejection Reasons
Based on our experience and community reports, here are the top rejection reasons: (1) Missing or broken GDPR webhooks — this is an instant rejection. (2) Requesting unnecessary API scopes — if you request write_products but never write products, you'll be flagged. (3) App doesn't work in the embedded context — your app must work inside the Shopify Admin iframe. (4) Missing Privacy Policy or Terms of Service pages. (5) Billing integration that doesn't handle cancellation properly. (6) Using deprecated API versions. Fix these before submitting and you'll save weeks of back-and-forth.
The Testing Guide You Must Write
Shopify requires a testing guide that explains how reviewers can test your app's features. This is your chance to make the reviewer's job easy — and a happy reviewer is a fast reviewer. Structure it as: Step 1 (install the app), Step 2 (navigate to feature X), Step 3 (try action Y). Include screenshots for complex flows. If your app has multiple features, create a checklist the reviewer can follow. The ShopForge scaffold includes a template for this in the documentation.
App Listing Optimization
Your app listing is your storefront in the App Store. Key elements: (1) App name — clear and descriptive, not clever. 'Order Discount Rules' beats 'DealNinja'. (2) Description — focus on what the merchant gains, not technical features. (3) Screenshots — show the actual app UI, not marketing graphics. Shopify prohibits text overlays like 'Free' or 'Best Seller' on screenshots. (4) App icon — simple, recognizable at small sizes. (5) Support URL and email — must be responsive; Shopify checks this.
Timeline and What to Expect
The review typically takes 5-10 business days, but can stretch to 3-4 weeks during busy periods (Q4 before Black Friday). After submission, a reviewer will install your app on a test store and walk through your testing guide. If they find issues, they'll send a detailed rejection email with specific items to fix. You fix them, resubmit, and the review restarts. Pro tip: use the waiting period to prepare your marketing materials, write blog posts, and set up your landing page — that's exactly what we did with ShopForge's website while our apps were in review.
How ShopForge Helps
The ShopForge scaffold is designed with App Store approval in mind. It includes: working GDPR webhooks (CUSTOMERS_DATA_REQUEST, CUSTOMERS_REDACT, SHOP_REDACT), proper OAuth implementation with HMAC verification, billing integration with cancellation handling, Privacy Policy and Terms of Service pages, Polaris UI throughout, and a testing guide template. Every feature that Shopify reviewers check is pre-built and pre-tested.