> For the complete documentation index, see [llms.txt](https://docs-shpf.bsscommerce.com/bss-b2b-lock-login-password-hide-price/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-shpf.bsscommerce.com/bss-b2b-lock-login-password-hide-price/getting-started/install-and-open-bss-b2b-lock.md).

# Install & Open BSS B2B Lock

The Auto Installation feature adds the app’s code to your Shopify theme in a few clicks — no manual editing required. It works on both free and paid themes, though results may vary depending on your theme and plan setup.

Availability may vary by plan and theme type. If auto installation does not work on your theme, use the Manual Installation method or contact support.

| <p><strong>Note</strong></p><p>BSS B2B Lock & Login does not operate solely through Shopify’s native Online Store 2.0 system (for example, App Embeds or standalone Theme App Extensions). To apply lock rules correctly on the storefront, the app must install code into your theme.</p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

| <p><strong>Best practice</strong></p><p>Install to your TEST (Draft) theme before going live. This lets you verify the lock rules work correctly without affecting your real customers.</p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **1. Eligibility Requirements**

Make sure you meet all of the following before running Auto Installation:

* The BSS B2B Lock & Login app is installed in your Shopify store
* You have at least one published (Live) theme or draft theme in your store
* You have created at least one lock rule in the app before testing
* You have Admin access to your Shopify store

### **2. Understanding Auto Installation**

Auto Installation injects the app’s code snippets into your selected Shopify theme. Without this step, your lock and login rules will not appear or function on your storefront — even if they are enabled in the app.

**What it does**

* Adds the necessary code to display lock messages, login prompts, and access rules to buyers
* Connects your configured rules (e.g., “lock product if customer is not signed in”) to the live storefront
* Keeps your other theme files and customizations intact

**What you can do**

* **Install to LIVE:** Install to a LIVE (Published) theme — your real storefront customers will see the rules immediately
* **Install to TEST:** Install to a TEST (Draft) theme — verify everything works before affecting customers
* **Reinstall:** Reinstall at any time if the code is removed or a theme update overwrites it

**Where it applies**

* All pages and products covered by your lock rules (e.g., collections, individual products, entire store)
* Works on Shopify Online Store 2.0 themes and most legacy themes

### **3. Availability & Limitations**

| **Scenario**                                     | **Auto Installation** | **Recommended action**                                       |
| ------------------------------------------------ | --------------------- | ------------------------------------------------------------ |
| Free Shopify themes (e.g., Dawn)                 | Supported             | Use Auto Installation normally                               |
| Paid third-party themes (e.g., Empire, Stiletto) | May vary              | Try Auto Installation; use Manual if it fails                |
| Headless or custom-built storefronts             | Not supported         | Contact support for guidance                                 |
| Store already has working code installed         | Caution               | Skip Auto Install — re-installing may break existing setup   |
| Multiple draft themes                            | Supported             | Select the correct theme from the dropdown before installing |

| <p><strong>Caution</strong></p><p>If your store is already showing lock rules correctly, do not run Auto Installation again. It may cause incompatibility with your existing setup.</p> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **4. How to Run Auto Installation**

**Step 1 — Go to Installation settings**

1. **Open the app:** Open the BSS B2B Lock & Login app. Go to your Shopify Admin → Apps → BSS B2B Lock & Login.
2. **Click Installation:** Click the “Installation” tab at the top of the app, next to Translation and Template email.
3. **Select Auto Installation:** Confirm “Auto Installation” is selected. If Manual Installation is highlighted, click Auto Installation instead.

<figure><img src="/files/gvm7fD9PnfXwFKfbZiZo" alt="Auto Installation tab — select Install to TEST (Draft) and click Install"><figcaption><p><em>Auto Installation tab — select Install to TEST (Draft) and click Install</em></p></figcaption></figure>

**Step 2 — Choose your theme and install**

1. **Select TEST (Draft):** Click the radio button next to Install to TEST (Draft) — Recommended for testing.

| <p><strong>Note</strong></p><p>Always test on a draft theme first. The Live option affects your real storefront immediately.</p> |
| -------------------------------------------------------------------------------------------------------------------------------- |

1. **Select your theme:** Click the dropdown (e.g., “Theme Dawn (Current Target)”) to see all your available themes. Select the one you want to install to.

| <p><strong>Note</strong></p><p>The theme marked “Current Target” is the one the app is currently configured to work with. Install to this theme first when testing.</p> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<figure><img src="/files/7hXfpOX4OqFoqxP0HDZn" alt="Theme dropdown — select your target theme from the list"><figcaption><p><em>Theme dropdown — select your target theme from the list</em></p></figcaption></figure>

1. **Click Install:** Click the Install button. The app will inject the required code into your selected theme. This takes a few seconds.

| <p><strong>Note</strong></p><p>After a successful installation, the “Latest Install (Date)” field will show the timestamp. If it still shows “Invalid Date”, the installation has not been completed yet.</p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **5. Verifying the Installation Works**

**Check the install target**

1. **Check the banner:** Go back to the main rules list in the app. A banner at the top shows the current install target (e.g., “Install target: Dawn — Draft Theme”).
2. **Confirm the target:** Confirm the target matches the theme you just installed to. If it does not match, click “Change” in the banner to update.

| <p><strong>Note</strong></p><p>Rules saved here won’t affect your live store if the install target is set to a draft theme.</p> |
| ------------------------------------------------------------------------------------------------------------------------------- |

<figure><img src="/files/sdS6Bx2squD0nalCVeJo" alt="Rules list — the install target banner shows which theme is active"><figcaption><p><em>Rules list — the install target banner shows which theme is active</em></p></figcaption></figure>

**Preview the storefront**

1. **Go to Themes:** Go to Shopify Admin → Online Store → Themes. Find your draft theme and click Preview.
2. **Navigate to locked content:** Navigate to a locked collection or product. Confirm the lock message or login prompt appears as expected.
3. **Test with a customer account:** Log in as a tagged customer that meets your rule condition and confirm they can access the content.

### **6. Resolving Common Issues**

**Lock rules are not showing on the storefront**

* Check that the app’s install target matches the theme you are previewing
* Re-run Auto Installation on the correct theme
* Clear your browser cache and refresh the storefront preview

**Latest Install date shows “Invalid Date”**

* This means installation has not been successfully completed on that theme
* Select the theme from the dropdown again and click Install
* If the issue persists, try Manual Installation instead

**Auto Installation does not work on your paid theme**

* Paid themes may have custom code structures that block auto-injection
* Switch to the Manual Installation tab and follow those steps
* Contact support if you are unsure which files to edit

**The install broke an existing feature on the theme**

* Go to Shopify Admin → Online Store → Themes
* Click “Actions” on the affected theme → “Edit code”
* Revert the theme to a previous backup if available, or contact support immediately

**Rules are saved but the banner says “Rules won’t affect your live store”**

* This is expected behavior when the install target is a draft theme
* Once testing is complete, install to your LIVE theme and update the install target

### **7. Third-Party Theme Support**

BSS B2B Lock & Login is tested and compatible with common Shopify free themes including Dawn, Ride, Horizon, and Spotlight. For third-party paid themes (Enterprise, Empire, Eurus, Ella, etc.), Auto Installation may partially work.

* Always run a test install on the draft version of a paid theme before going live
* If lock messages do not appear after install, use Manual Installation for paid themes
* Themes built outside Shopify’s standard structure (headless builds) require custom integration — contact support

### **Still Need Help?**

Our support team can walk you through installation on any theme, help troubleshoot lock rules that are not showing, or assist with Manual Installation on paid or custom themes.

Email us and include your store URL and a screenshot of the Installation tab:

<support-sbc@bsscommerce.com>