Guidance Requested for BFS Audit

Hello Shopify Team,

Dima here from the Product team at Loox.

We appreciate Shopify’s dedication to maintaining high standards for apps through the Built for Shopify program. As we work on aligning our app with the audit requirements, we’ve encountered a few questions and would appreciate your guidance on the following:

1. Broken Screenshot Link
We noticed a broken link to a screenshot in our audit. Who should we reach out to for assistance with this?

2. Onboarding Dismissibility Requirement
We received this requirement:
“Make your onboarding dismissible using a Polaris Cancel icon. Please refer to our App Design Guidelines and see this screenshot for additional details.”
Upon reviewing the documentation, we found the clarification:
“If your onboarding isn’t essential, then make it dismissible using a Polaris Cancel icon.”
Our app’s onboarding is essential as it includes critical steps, such as implementing our core script (App Embed Block), which is necessary for the app to function. Additionally, our onboarding flow has a very high completion rate, we see that merchants find it very much effective.

Could you please provide further clarity on the criteria for what is considered “essential” in this context? as we would most definitely consider it as essential.

3. Polaris Patterns for Common Layouts
Another requirement we received states:
“Keep your app aligned with the Shopify admin by using the Polaris Patterns for common layouts such as settings pages.
Our app includes multiple products, and the navigation structure follows this setup:

  • The main navigation (Shopify’s left pane) lists of our products.
  • Inside each product, we use top bar tabs for secondary navigation.
  • Some pages include a third level of navigation due to the extensive settings and entry points for internal pages.

While Polaris Patterns for common settings layouts make sense for purely settings-based pages, they don’t align well with pages that mix navigation, settings, internal page entry points, and additional features like in our example.

We checked other Shopify native apps and found a mix, some use the common Polaris settings layout, while others adopt a structure similar to ours (sometimes within the same app).

For example:

In many ways, this is similar to what Shopify has in the main settings:

Adopting this requirement across all pages that include settings, would significantly impact our current structure, we’d greatly value your guidance on how to proceed in this scenario.

Thank you for your time and support!

Best regards,
Dima, Loox Product Team

Hi Dima!

DMing you with some info on this.

1 Like