Most Built for Shopify applications that don’t pass review fail due to the same common issues.
Use this checklist to audit your app against the most frequently missed requirements. Addressing these proactively can help you pass review on the first submission and avoid unnecessary delays.
10 common failures
1. (4.2.3) Communicate theme block status on homepage
Requirement: Apps using theme app extensions must clearly show merchants whether blocks are enabled or disabled directly on the app homepage.
Why apps fail: Merchants have to navigate to the theme editor to check block status, creating unnecessary friction.
View requirement in dev docs →
2. (4.1.5) Enforce interaction with Contextual Save Bar
Requirement: When merchants make changes in a form, they must interact with the Contextual Save Bar (CSB) before navigating away. The app should prevent navigation until changes are saved or discarded.
Why apps fail: Apps allow merchants to navigate away without saving, risking data loss.
View requirement in dev docs →
3. (4.3.3) Don’t display unsolicited modals or popovers
Requirement: Apps must not automatically display modals, popovers, or overlays without merchant action.
Why apps fail: Automatic popups interrupt merchant workflows and create a distracting experience.
View requirement in dev docs →
4. (4.3.3) Only use red for error messages
Requirement: Red styling should be reserved exclusively for error states and critical alerts.
Why apps fail: Apps use red for branding, CTAs, or non-error UI elements, creating confusion about what’s actually an error.
View requirement in dev docs →
5. (4.1.2) Optimize layout for mobile
Requirement: App layouts must be fully functional and optimized for mobile devices.
Why apps fail: UI elements overlap, content is cut off, or key features are inaccessible on smaller screens.
View requirement in dev docs →
6. (4.1.5) Integrate forms with Contextual Save Bar
Requirement: All forms must integrate with the Contextual Save Bar (CSB) to provide a consistent save/discard experience.
Why apps fail: Forms use custom save buttons instead of the CSB, creating an inconsistent merchant experience.
View requirement in dev docs →
7. (4.3.6) Make all promotional content dismissible
Requirement: Any promotional content (upgrade prompts, feature announcements, ads) must be permanently dismissible.
Why apps fail: Promotional content reappears after being dismissed or lacks a clear dismiss option.
View requirement in dev docs →
8. (4.2.2) Make onboarding dismissible
Requirement: Onboarding flows, tooltips, and guided tours must be dismissible and not block access to core app functionality.
Why apps fail: Merchants are forced to complete onboarding before accessing the app, or can’t dismiss onboarding prompts.
View requirement in dev docs →
9. (4.1.2) Make all content accessible on mobile
Requirement: All app content and functionality must be accessible and usable on mobile devices—no hidden or unreachable features.
Why apps fail: Critical features or content are only available on desktop, or mobile navigation makes features impossible to find.
View requirement in dev docs →
10. (4.2.2) Show onboarding immediately after install
Requirement: Onboarding must be visible immediately after app installation and easy to find if a merchant needs to return to it later.
Why apps fail: Merchants land on a blank or confusing screen after install, or can’t locate onboarding again after dismissing it.
View requirement in dev docs →
Ready to submit?
Review the complete Built for Shopify requirements to ensure your app meets all criteria, then head to your Built for Shopify dashboard to submit your application.
Already submitted?
You can still update your app before your review begins. Avoid delays and fast-track your approval by making sure you meet the complete Built for Shopify requirements, including the ones mentioned above.