Contextual Save Bar fails to block breadcrumb navigation - Built for Shopify compliance issue

Built for Shopify
1

In our app’s annual review, we’ve been working through our revisions, and we’re stuck on one involving the CSB.

During this retest, I did find an issue with the Contextual Save Bar (CSB). Please see this screenshot for details.

The Save Bar correctly blocks app navigation and nav menu clicks when unsaved changes exist, but fails to block breadcrumb navigation, violating BFS requirement 4.1.5.

Screenshot 2025-08-14 at 13.17.59
Screenshot 2025-08-14 at 13.17.591184×501 77.4 KB

Is this a known issue? What am I missing here?

What’s the recommended approach for BFS compliance?

1 Like
2

Looks like the leaveConfirmation method gives us a fix.

We can add this as the first line in our breadcrumb handler:

await shopify.saveBar.leaveConfirmation()

And that will:

  1. NOT show any sort of confirmation, (despite the name of the method)
  2. await will basically hang forever if the save bar is present
  3. which will prevent navigation

Hopefully that works.