Turn On B2B Prices on Version 5
On version 5, BSS B2B Solution needs two things before logged-in customers see B2B prices: permissions you approve in Shopify, and the app embed turned on in your live theme. This page covers both, and what to do if you cancelled the permission screen.
Who this is for
Section titled “Who this is for”- New installs. A new store starts on version 5.
- Reinstalls on version 5.
- Stores that moved from version 3 to version 5. See Checkout Version and Checkout Method.
To see your version, open Settings in the app and look at the Checkout version row. Stores on version 3 are never asked for these permissions. On version 3 you only need the app embed. See Enable or Disable the App in Your Theme.
Approve the permissions on first open
Section titled “Approve the permissions on first open”The first time you open the app after you install it, Shopify’s permission screen opens by itself. The app screen behind it is blank. The screen asks only for the permissions the app does not have yet.
Approve them, cancel, or close the screen. In every case the app then continues into the onboarding guide. The app asks once on first open and does not ask again by itself. If you cancelled, use Allow access below.
If you reinstall the app while your store is on version 5, the screen opens again on the first open after the reinstall.
Until the permissions are approved and the app embed is on, logged-in B2B customers see your regular prices. Your rules and settings are saved either way.
Allow access
Section titled “Allow access”If permissions are still missing, the app shows a reminder in two places.
| Where | What you see |
|---|---|
| Home > To do card, group Stopping B2B prices | The row Allow access to show B2B prices with the button Allow access. |
| Settings > Checkout version | A banner Allow access to show B2B prices with Allow access. In Checkout health, the App permissions row shows Action required with a Grant permissions button. |
- Click Allow access, or Grant permissions in Checkout health.
- Shopify opens its permission screen. Read it and approve.
- The row and the banner disappear. App permissions shows Passed after you click Re-check.
If you cancel again, the app shows Access not granted yet. and the reminder stays. If the screen does not open, the app shows Couldn’t open the access request. Please try again. Click the button again.
Shopify decides who can approve app permissions. If Shopify does not let you approve, see the FAQ below.
What the access includes
Section titled “What the access includes”Click What’s included? next to Allow access to see the list in the app. It covers three things:
| In the app | Why it is needed |
|---|---|
| Read products | To show B2B prices on your store. |
| Update carts and checkouts | To carry B2B prices to checkout. |
| Checkout rules | To stop orders that break your B2B rules, for example an express pay button or a direct link to /checkout. |
None of these lets the app read your customers. Shopify words each permission in its own way, so its screen will not match this table line for line.
Technical names
Shopify shows these as app scopes:
unauthenticated_read_product_listingsandunauthenticated_read_product_tags: read products.unauthenticated_write_checkouts: update carts and checkouts.write_validations: checkout rules.
Turn on the app embed
Section titled “Turn on the app embed”You can do this in the last step of the onboarding guide, Turn on app embed, or from the To do card on Home.
- Click Open theme editor. The app opens the theme editor on your live theme.
- Under App embeds, turn on BSS B2B Solution, then click Save.
- Go back to the app tab. In onboarding the app checks for you, and Check again repeats the check. On Home, click I turned it on.
The To do card row for this is Turn on BSS B2B in your theme. How? opens the help article. For each screen of the theme editor, see Enable or Disable the App in Your Theme.
The app embed belongs to one theme. When you publish a new or duplicated theme, turn it on there too.
Check it works
Section titled “Check it works”On Home, the To do card must list nothing under Stopping B2B prices. When you turn the embed on while Home is open, the card shows B2B prices are live on your store. Customers who log in now see them. with a View store button. That line only confirms the app embed. If Allow access to show B2B prices is still listed, customers still see regular prices.
The card can also list a group named Waiting on you, for example applications to review. Those items do not stop B2B prices.
Then check the storefront yourself. Log in as a B2B customer who matches one of your rules, in a private browser window, and check that:
- A product page shows the right B2B price.
- A collection page shows the right B2B prices.
- The cart shows the same price.
- Checkout shows the same price.
You can also open Settings > Checkout version and read Checkout health. If a price is wrong, see Troubleshooting: B2B Prices or Rules Not Showing.
I clicked Cancel on the permission screen. Nothing is lost. The app does not open the screen again by itself. Click Allow access in the To do card on Home, or on Settings > Checkout version.
I am staff and cannot approve the permissions. Ask the store owner, or a staff member Shopify lets approve app permissions, to open the app and click Allow access. The reminder stays on Home until someone approves.
I reinstalled the app. Do I need to do it again? If your store was on version 5, the permission screen opens on the first open after the reinstall. If you cancel, or the To do card shows Allow access to show B2B prices, click Allow access. Until then logged-in customers see regular prices. A store on version 3 stays on version 3 and is not asked.
I never saw the permission screen. Stores installed before this change are not asked on open. They see the reminder in Home and Settings instead. The screen also does not open for a store that already has every permission.
What does Use version 3 instead do? It sits next to Allow access in the To do card and in the Settings banner, and opens a window that compares the two choices. Click Use version 3 to move your store back to version 3. B2B prices work there without these permissions. The window says version 3 gets no new features and will gradually be deprecated. It works only while your store is on version 5 and at least one version 5 permission is still missing. Once every permission is granted, the app refuses it. Going back is then a request to support: our team moves the store back, which takes about one business day. If the switch fails, the window offers a contact us link. You can move to version 5 again in Settings > Checkout version.
I changed my theme and B2B prices stopped. The app embed is set per theme. Open the theme editor on the new theme, turn on BSS B2B Solution under App embeds, and click Save.
I am on version 3. Do I need this? No. On version 3 you only need the app embed on. To see your version, open Settings and read the Checkout version row.