Top eight tips for getting your Shop Mini submission approved

Shop Minis
1

As the number of submissions grows daily, we’re seeing common rejection patterns.

Here are the top eight tips to help you sail through the approval process:

  1. Test properly: Test on real iOS AND Android devices (not just simulator), verify your backend is deployed and accessible.

  2. No localhost: Remove localhost from trusted_domains—instant rejection.

  3. No env variables: Hardcode production API URLs or use build-time config—runtime env variables won’t work.

  4. Real assets: Real app icon (not placeholder), real privacy policy & terms URLs (not example.com).

  5. Naming: Clear name and description, don’t use “Shop” or “Mini” in your name, don’t reuse an existing Mini’s name.

  6. Use SDK components: ProductCard for products, Lucide icons instead of emojis, handle different image aspect ratios gracefully.

  7. Navigation: Use MinisRouter for multi-screen flows with proper back navigation.

  8. Polish: Mobile-friendly large tap targets, loading states for async operations, remove console.log statements. Please ensure your Mini meets the design guidelines before submitting.

Resources: Design Guidelines | Full Guidelines

P.S. Have a submission rejected? That’s okay. Just review and implement the feedback, thoroughly test, and submit again.

1 Like
3

Hey @davidhoffman-shopify ,

Thank you for reminding us the core things to look into before the submission. Quick question, is the usage of MiniRouter a requirement for submission for multi-screen minis or it’s a recommendation for a smoother navigation?

Thank you!

4

@ssvinarciuc it’s recommended but not required

1 Like
5

Hi David, thanks for sharing these review tips !
We’re preparing our submission and noticed the point about real assets..We updated our app manifest.json(name and description) and app icons, but the changes don’t show up in our test Mini.

Clipboard_Screenshot_1764211433
Clipboard_Screenshot_1764211433939×280 17.4 KB

Do these updates only appear after submitting/publishing?

Thanks!

6

manifest changes require stopping the dev server and re-running npx shop-minis dev to preview