Skip to content

App Settings, Installation & Maintenance

Manage global store-wide settings for BSS B2B Lock, including Theme Editor visibility, theme installation, registration form options, and code cleanup.

While individual lock rules are configured with their own targets and conditions, the Settings area in BSS B2B Lock manages global, store-wide behaviors, theme integration environments, and code lifecycle management.


  1. Lock in Theme Editor
  2. Choosing Where to Install (Live vs Other Themes)
  3. App Embed
  4. Registration Form Options
  5. Theme Cleanup & Disabling Rules Before Uninstalling
  6. Summary of Global Settings vs Per-Rule Settings

In Settings > Installation, the Lock in Theme Editor card controls whether lock rules take effect inside the Shopify Theme Customizer/Editor.

  • Setting Location: BSS B2B Lock → Settings → Installation → Lock in Theme Editor
  • Default State: ON (enabled by default for all stores to comply with Shopify App Store requirements and ensure WYSIWYG editing).
  • Storefront Behavior: When enabled, whenever you or your team open Shopify Admin → Online Store → Themes → Customize, the preview renders locked content exactly as a customer would experience it.
  • Troubleshooting / Merchant Tip: If you need to edit theme sections, customize layout blocks, or adjust styling freely without triggering app lock overlays or login gates in the theme preview, click Disable Lock in Theme Editor. Click Enable Lock in Theme Editor once your visual editing is complete.

2. Choosing Where to Install (Live vs Other Themes)

Section titled “2. Choosing Where to Install (Live vs Other Themes)”

Testing B2B locks on a live production storefront can disrupt active customers. The Installation tab lets you install the app’s code on your live theme or on any other theme, such as a duplicate you use for testing.

  • Setting Location: BSS B2B Lock → Settings → Installation → Auto Installation
  • Install on the live theme:
    1. Select Auto-install on Live theme. The card shows Theme name : [Theme Name] with a Live theme badge.
    2. The installation starts right away. There is no confirmation window.
  • Install on another theme (for example, to test first):
    1. Select Select themes to install.
    2. Open the Theme dropdown. It lists every theme in your store. Your published theme appears as [Theme Name] (Live theme).
    3. Choose the theme and click Install.
    4. The badge next to the Lock list title shows the theme your rules apply to, for example Draft theme: [Theme Name].
    5. Lock rules created or edited in the app only run when previewing that specific theme.
  • When Install appears: The Install button only shows when the chosen theme is not already the installed theme. A theme that is already set up shows just its name and the latest install date.
  • Reinstalling: Clicking Install on a theme that already has the app’s code refreshes the rule content. It is a safe way to update a theme.

The BSS B2B Lock App Embed connects the app’s locking logic and rules to your storefront theme:

  • Where to check it: The Settings > Installation screen no longer has an App Embed card. Check the embed on the Dashboard App status card (Storefront embed shows On or Off, with a Turn on button) or directly in the Shopify theme editor.
  • Theme Switching: Whenever you publish a new theme or duplicate your active theme, always verify that the BSS B2B Lock app embed is turned ON in Shopify Admin → Online Store → Themes → Customize → App Embeds.

BSS B2B Lock works through two parts:

Part Where you manage it What it powers
Code installed in your theme Settings > Installation > Auto Installation (or Manual Installation) Locking pages, products, collections, variants and prices
App embed “B2B Login By BSS” (shown in the app as BSS B2B Lock, Login app embed) Online Store > Themes > Customize > App embeds Passcode pop-up on collections, request access, and hiding accelerated checkout buttons (Buy it now, Shop Pay, and so on) on product and cart pages

Keep both on. If locks on pages or prices do not work, check the installed code first; if the passcode pop-up, request access form or hidden checkout buttons do not work, check the app embed.

  • Auto Installation: choose your theme and click Install. Auto installation works on free Shopify themes. If the code is already installed and working, do not run it again: it can cause conflicts.
  • Manual Installation (typically about 15 minutes): for paid or customized themes. The page walks you through three checks (the snippet files exist, the include line is at the top of theme.liquid, and it sits inside the right tag), then shows where to paste the code for Hide Product, Hide Collection and Hide Variant, with the usual file names for the Dawn theme.
  • If you need help with a manual installation, click Contact support: our team installs it for free (you may be asked for a collaborator request code).

In Settings > Installation, the Registration form card has two switches for stores that do not want public sign-ups, for example invite-only stores or stores where you approve every customer.

  • Disable registration form: The register page shows an empty area instead of the sign-up form, and register links on the login page are hidden.
  • Hide “Create account” link: Hides the link to the register page on the login page.

Registration form card with the Disable registration form and Hide Create account link switches

Toggle a switch to apply it. The theme is updated automatically after each change, and a message confirms it was saved. These options apply to themes that use classic customer accounts. They need a paid plan; on the Free plan the card shows an upgrade link.


5. Theme Cleanup & Disabling Rules Before Uninstalling

Section titled “5. Theme Cleanup & Disabling Rules Before Uninstalling”

If you ever decide to change themes, pause usage, or uninstall BSS B2B Lock, you should always deactivate all active rules and remove injected snippets first to prevent accidental customer lockouts.

  • Setting Location: BSS B2B Lock → Theme Cleanup (left navigation menu) or Settings → Installation → Before you uninstall
  • Why this is critical:
    • Auto-installation injects theme Liquid snippets to ensure locks work reliably across all page templates.
    • If the app is uninstalled directly from Shopify Apps without running cleanup, orphaned code snippets can remain in your theme files and keep pages locked.
  • The Before you uninstall card: The Installation screen has a Before you uninstall card. It explains that uninstalling does not remove the code B2B Lock added to your theme, and offers a Clean up B2B Lock code button. Click it, choose the themes to clean, and confirm. If no theme has B2B Lock code, the window says so.
  • The New Theme Cleanup Page (One-Click Deactivation):
    • The dedicated Theme Cleanup page checks whether lock rules are active on any theme across your store.
    • Click Disable all rules and confirm to deactivate 100% of lock rules across all themes, clean up draft theme injections, and instantly restore standard storefront browsing.
    • For full details and step-by-step instructions, see the dedicated Theme Cleanup Guide.

6. Summary of Global Settings vs Per-Rule Settings

Section titled “6. Summary of Global Settings vs Per-Rule Settings”
Scope Where Configured Examples
Global App Settings App Settings / Installation / Theme Cleanup Theme Editor visibility toggle, theme installation (Live vs other themes), registration form options, Theme Cleanup & One-Click Rule Deactivation
Per-Rule Settings Rule Builder (BSS B2B Lock → Locks → Add lock rule or Edit) Step 3 – Exclude Pages: Home page, Customer areas, Policy pages, Specific pages (URLs), Selected products; for page locks, the SEO noindex meta tag and hiding the store’s header, footer and navigation bar. Lock message: edit it from the Preview card → Customize message (text content and Custom CSS).

If you have questions or need assistance configuring BSS B2B Lock, our dedicated support team is here to help.

  • In-App Assistance: Click Need help? or use the in-app chat button within BSS B2B Lock.
  • Email Support: Contact us at [email protected] with your store URL and specific rule details.