Embed Settings

Configure which forms FormSentry protects using smart detection and CSS selectors.

The embed settings control which forms on your storefront are monitored by FormSentry. You can configure these in your theme editor under the FormSentry app embed.

Accessing Embed Settings

  1. Go to Online Store → Themes → Customize.
  2. Click the App Embeds icon in the sidebar.
  3. Click on FormSentry to expand its settings.

Smart Detection

SettingDefault
Smart detectionEnabled

When enabled, FormSentry automatically identifies and protects Shopify’s built-in contact forms and blog comment forms. It detects these forms by analyzing the form structure and action URLs. No configuration needed.

Recommendation: Leave this on unless you have a specific reason to disable it. It handles the most common form types automatically.

Custom Form Selectors

If you have additional forms you want to protect (beyond the standard contact and comment forms), you can add their CSS selectors.

SettingDescription
Protect these formsCSS selectors for additional forms to monitor
Exclude these formsCSS selectors for forms to never protect

Protect These Forms

Enter one CSS selector per line. FormSentry will monitor any form that matches these selectors in addition to the auto-detected forms.

Examples:

#custom-contact-form
.newsletter-signup form
[data-form-type="inquiry"]

Exclude These Forms

Enter one CSS selector per line. Any form matching these selectors will be ignored by FormSentry, even if smart detection would normally catch it.

Examples:

#login-form
.checkout-form
.search-form

Use cases for exclusion:

  • Login or account forms that shouldn’t be filtered
  • Checkout forms (Shopify handles these separately)
  • Search forms or other non-contact forms
  • Third-party app forms that have their own spam protection

Important Notes

  • FormSentry only works with forms on your Shopify storefront. It does not protect third-party form builders (Google Forms, Typeform, JotForm, etc.).
  • Changes to embed settings take effect immediately after saving in the theme editor.
  • The embed script only activates on pages that contain matching forms.