Advanced sign-up form customisation

Use the app's sign-up form settings for standard changes. For a custom theme, add JavaScript configuration to the window.BISAData object before the Back in Stock Alerts storefront script runs.

Override storefront settings

1. Open BigCommerce Script Manager.
2. Create an Essential script placed in the page header.
3. Initialise window.BISAData, then set the values you need to override.

For example, change the successful-unsubscribe heading:

<script>
  window.BISAData = window.BISAData || {};
  window.BISAData.unsubscribe_success_heading = "You've successfully unsubscribed";
</script>

Customise unsubscribe messages

When a customer follows an unsubscribe link from an email, the storefront shows a modal confirming whether the request succeeded. Override its text with:

<script>
  window.BISAData = window.BISAData || {};
  window.BISAData.unsubscribe_success_heading = 'Success';
  window.BISAData.unsubscribe_success_message = 'You have been unsubscribed from back-in-stock alerts.';
  window.BISAData.unsubscribe_failure_heading = 'There was a problem';
  window.BISAData.unsubscribe_failure_message = 'We could not unsubscribe you from back-in-stock alerts.';
  window.BISAData.unsubscribe_button_label = 'Continue';
</script>

Show the sign-up form manually

Call forceShowFormForProduct after the Back in Stock Alerts storefront script has loaded. Pass a product ID:

window.BISAData.forceShowFormForProduct({id: 97});

For a particular variant, include its variant ID:

window.BISAData.forceShowFormForProduct({id: 97, variantId: 134});

Configuration reference

The app writes the active configuration to window.BISAData on page load. Values set by your header script can override these fields.

Field	Type	Purpose
api_domain	string	API origin. The current production origin is https://backinstockalerts.hypaapps.com.
store_hash	string	BigCommerce store hash.
channel_id	number	Current storefront channel ID.
currency_id	number	Current storefront currency ID.
customer_id	number	Logged-in customer ID.
customer_first_name	string	Logged-in customer's first name.
customer_last_name	string	Logged-in customer's last name.
customer_email	string	Logged-in customer's email address.
enable_newsletter_signup	boolean	Shows the newsletter-consent option.
form_type	string	Form display: inline or modal.
button_settings.button_class	string	Space-separated CSS classes for the trigger and submit buttons.
button_settings.override_styles	boolean	Enables the custom button style values.
button_settings.modal_text	string	Modal trigger button text.
button_settings.submit_text	string	Form submit button text.
button_settings.background_color	string	Button background colour.
button_settings.text_color	string	Button text colour.
button_settings.hover_background_color	string	Button hover background colour.
button_settings.hover_text_color	string	Button hover text colour.
button_settings.border_radius	string	Button border radius.
subscribe_message	string	Form heading.
success_message	string	Successful-submission message.
newsletter_label	string	Newsletter checkbox label.
privacy_text	string	Consent guidance shown near the submit button.
enable_first_name	boolean	Collects the customer's first name.
enable_last_name	boolean	Collects the customer's last name.
form_element_selector	string	Add-to-cart form selector.
product_id_element_selector	string	Product ID input selector.
option_input_element_selector	string	Variant option input selector.
option_select_element_selector	string	Variant option select selector.
add_to_cart_button_element_selector	string	Add-to-cart button selector.
quickview_modal_element_selector	string	Quick View modal selector.
replace_add_to_cart_button	boolean	Replaces the original add-to-cart button with the alert experience.
unsubscribe_success_heading	string	Successful-unsubscribe modal heading.
unsubscribe_success_message	string	Successful-unsubscribe message.
unsubscribe_failure_heading	string	Failed-unsubscribe modal heading.
unsubscribe_failure_message	string	Failed-unsubscribe message.
unsubscribe_button_label	string	Button that dismisses the unsubscribe modal.
forceShowFormForProduct	function	Opens the alert form for a product and optional variant.
enable_alert_requests	boolean	Enables or disables the storefront sign-up experience.

Avoid overriding store, customer and API values unless you are implementing a custom storefront flow and understand how those values are supplied.