# Turn on the app embed

> Switch on the app embed in your theme so the application form and your store access rules work on the storefront.

App: Sami B2B Registration & Signup (Shopify app by Samita)
Source: https://docs.samita.io/sami-b2b-onboarding/getting-started/turn-on-the-app-embed
Last updated: 2026-10-06

The app embed is the part of Sami B2B Onboarding that runs in your theme, on every storefront page. Shopify doesn't turn app embeds on when you install an app, so you switch it on yourself, once for each theme.

## What the embed does

With the embed on, your storefront:

- shows the application form on the page the app creates for each form
- hides prices and add to cart from visitors who aren't approved, if you turned that on
- locks the store, including a private wholesale store, and shows visitors the prompt to log in or apply
- runs **Test mode**, so you can try your rules on your own account first

You choose these rules in **Settings › Access**. **Block checkout while pending** doesn't need the embed: Shopify checks it at checkout.

## Turn it on from Home

1. ### Open the app

   In Shopify admin, click **Apps**, then **Sami B2B Onboarding**. The app opens on **Home**.

2. ### Open the theme editor

   On the **Turn on the app embed** card, click **Activate embed**.

   If you closed that card, look at the top of the **Recent activity** card instead. Next to **App embed**, click **Open theme editor**.

   The theme editor opens in a new tab, on your published theme. The **Sami B2B Onboarding** app embed is already switched on.

3. ### Save

   In the theme editor, click **Save**. Then close the tab.

   [Image: The theme editor's App embeds panel with the Sami B2B Onboarding embed switched on.]

   *Sami B2B Onboarding is already switched on in App embeds, so all that's left is to click Save.*

4. ### Check the status

   Go back to the app's tab. Home checks the embed again when you return. The **Turn on the app embed** card shows **Done**, and **App embed** in **Recent activity** reads **On**.

## Turn it on in the theme editor

You can also switch the embed on without going through the app.

1. ### Open your theme

   In Shopify admin, go to **Online Store › Themes**. Next to your current theme, click **Edit theme**.

2. ### Switch on the embed

   In the theme editor's sidebar, click **App embeds**. Find **Sami B2B Onboarding** and switch it on.

3. ### Save and check

   Click **Save**. Then open the app again. Home checks the embed each time the app opens, and **App embed** reads **On**.

## Check that it worked

- **In the app.** On **Home**, the **Recent activity** card shows **App embed** with **On** or **Off**. It reads **Checking…** while it looks. When the embed is on, click the refresh button beside the status to check again.
- **On your storefront.** In the app, go to **Forms** and click **Copy link** beside your form. Open the link in a private browser window. The form appears on the page. With the embed off, the page shows no form.

Your access rules never apply inside the theme editor, so you always see prices and buy buttons there. Test them on your live storefront, in a private window.

[Image: The Recent activity card header showing App embed with an On badge.]

*Home shows whether the app embed is on in your published theme.*

## Turn it off

1. ### Go to your theme

   In Shopify admin, go to **Online Store › Themes**. Next to your current theme, click **Edit theme**.

2. ### Switch off the embed

   Click **App embeds**, switch off **Sami B2B Onboarding**, and click **Save**.

With the embed off, the form pages the app creates show no form, and **Settings › Access** stops working on the storefront, except for the checkout block.

> **Caution**
>
> Turning off the embed opens a locked or private store to every visitor and shows prices you had hidden. **Block checkout while pending** still stops buyers who aren't approved at checkout.

## When you change themes

Each theme keeps its own app embed setting. Before you publish a different theme, open it in the theme editor, switch on **Sami B2B Onboarding** under **App embeds**, and save. Home reports the embed on your published theme.

## Next steps

- [Quickstart](https://docs.samita.io/sami-b2b-onboarding/getting-started/quickstart) — finish setting up and approve a test application.
- [Use the form page the app creates](https://docs.samita.io/sami-b2b-onboarding/add-a-form-to-your-store/use-the-form-page) — share the page that shows your form.
- [Store access](https://docs.samita.io/sami-b2b-onboarding/store-access/store-access) — choose what visitors who aren't approved can see and do.
- [Troubleshooting](https://docs.samita.io/sami-b2b-onboarding/help/troubleshooting) — what to check when the form or your rules don't show.
