BigCommerce has a built-in Script Manager for adding outside scripts to your store, and that is all the Yaplet widget needs. You copy one block of code from Yaplet, add it as a new script in BigCommerce, and the chat button appears on your store. You don't need an app or a developer.
Script Manager works on stores that use a Stencil theme. Some older stores still use the legacy Blueprint theme engine, which can't run Script Manager scripts.
1. Copy your Yaplet code
In the Yaplet dashboard's left menu, go to Brand → (your brand) → Chat widget → Install. If the tab asks where your website runs, choose Other website. Copy the code with the copy button on the code block.
If the code you copied starts with !function (Yaplet, it has no <script> tags around it yet. BigCommerce only saves a script that has these tags, so you add them in step 3.
2. Open Script Manager
In your BigCommerce control panel, go to Storefront → Script Manager and click Create a Script.
If your store uses Multi-Storefront, Script Manager is in each storefront's settings in Channel Manager. Add the script to every storefront where you want the chat.
3. Fill in the script
- Give the script a name you will recognize later, for example Yaplet chat.
- Place the script in the footer of the page.
- For the pages, choose Storefront pages. That is every page except checkout and order confirmation. BigCommerce asks for extra security checks on scripts that run on payment pages, so keep the chat off them.
- For the script category, choose Functional. BigCommerce lists live chat in this category.
- For the script type, choose the option to enter the script yourself (not a link to a URL).
- In the script field, paste the Yaplet code. The code must start with a
<script>line and end with a</script>line. If what you copied starts with!function (Yapletinstead, type<script>on a new line before it and</script>on a new line after it. - If BigCommerce asks for a load method, leave it on Default.
- Click Save.
4. Check your store
Open your store in a new browser tab and reload the page. A new script can take about 20 seconds to reach your store. The Yaplet chat button appears in the bottom-right corner. Click it to check that the chat opens.
For a full checklist, see Verify your installation.
If the chat doesn't appear
- BigCommerce says "Enter a valid script". The
<script>tags are missing. Type<script>on a new line before the code and</script>on a new line after it, then save. - You just saved the script. Wait a minute, then reload the page. Scripts can take about 20 seconds to show up.
- Your store shows a cookie consent banner. Shoppers who turn off functional cookies don't get the chat. To test, open your store in a private browser window and accept all cookies.
- Your store uses a Blueprint theme. Script Manager only works with Stencil themes. Switch to a Stencil theme to use it.
- The chat is missing only on checkout. That is expected: Storefront pages leaves out checkout and order confirmation.
What's next
To see what the code does and where your widget ID is, read Install Yaplet.