The Spoks Onsite Javascript is what allows certain Spoks features to run on your Shopify store — most notably, popup forms. It's a one-time setup that applies to all current and future features that depend on it. This article walks you through enabling it.
What requires the Spoks Onsite Javascript
The following Spoks features need the Spoks Onsite Javascript to be enabled before they'll appear on your store:
Popup forms — Overlay forms shown to visitors based on triggers like time delay, scroll, or exit intent.
Without the Spoks Onsite Javascript enabled, these features won't be displayed even if they're otherwise correctly configured.
Enabling the Spoks Onsite Javascript
The Spoks Onsite Javascript is enabled in the Shopify theme editor — but rather than navigating there manually, Spoks provides a button that takes you directly to the right place and pre-enables the embed block. All you need to do is save your theme.
The button lives in the How to use this form dialog inside Spoks. There are two ways to open this dialog, depending on whether you're setting up a brand new popup form or working with an existing one.
From the post-save dialog
When you save a popup form for the first time, the How to use this form dialog appears automatically. To enable the Spoks Onsite Javascript:
Click Enable Javascript in the dialog.
Wait for the Shopify theme editor to load.
Save your theme.
Once the theme is saved, the Spoks Onsite Javascript is active across your entire store.
From an existing popup form
If you've already created a popup form — for example, before completing the JavaScript setup, or because you skipped the post-save dialog — you can open the How to use this form dialog at any time:
Go to the forms page in Spoks. On web this is a table; on mobile it's a list.
Click (or tap) any of your popup forms — it doesn't matter which, since the setup applies to all of them.
Click the information button in the top-right corner of the form's overview.
The How to use this form dialog opens. From there:
Click Enable Javascript.
Wait for the Shopify theme editor to load.
Save your theme.
What else you need for popup forms to appear
Enabling the Spoks Onsite Javascript is the first step — but for a popup form to actually appear on your store, it also needs to have status LIVE. A DRAFT popup form is not displayed, even if the Javascript is enabled.
You can change a form's status from the form editor. For more on form status and how to configure popup forms, see Creating or editing a form or poll.