Skip to Content

Customize the Widget

Every visible element of the widget is editable from Settings → Lead Widget. Changes save automatically when you tab out of a field, and apply within ~60 seconds on every site (the widget’s config endpoint is cached briefly to keep load times fast).

Theme color

Pick any hex color. The bubble background, the form header, and the submit button all adopt the color. Default is WhatsApp green (#25D366) which feels native to the use case — most users keep it.

If you change it to match your brand, pick something that contrasts well with white text since the headline + button label are always white.

Position

Bottom-right (default) or bottom-left. Pick whichever doesn’t collide with other floating elements you have (chat support, cookie banners, back-to-top buttons).

Copy

FieldMaxWhere it appears
Bubble text40Tooltip next to the floating bubble
Headline60Top of the open form
Subheadline120Below the headline
Button text40Submit button on the form
Prefilled message500Pre-typed in WhatsApp after redirect

The prefilled message is what visitors see waiting in the WhatsApp input field after they click submit — they can edit it before sending, or send as-is. Use it to give your team context about where the lead came from:

Hi! I saw your pricing page and want to know about the Growth plan.

If the visitor wrote their own message in the form, that overrides the prefill — your team gets their actual intent rather than a generic template.

Form fields

  • Phone number — always required. Visitors must enter a valid phone in E.164-ish format (10–15 digits, optional + prefix).
  • Name — toggle on/off. Defaults to required since name massively improves lead quality.
  • Message — toggle on/off. Defaults to optional since a forced message field reduces submissions ~30%.

Branding

By default the form shows a small “Powered by Splashify Pro” credit line at the bottom. Toggle it off to hide. Your visitors won’t know the widget exists as a third-party tool.

Anti-spam

Domain allowlist

The most important defense — the widget refuses any submission from a domain not on your list. Origin spoofing is hard from a browser (browsers always set Origin on cross-site POSTs), so this catches 99% of abuse attempts.

Rate limit

10 submissions per IP per hour, automatic. Above the limit, the widget shows “Too many submissions” and the next attempt is rejected at the API level.

Cloudflare Turnstile (optional)

If you start seeing scripted abuse from real-looking IPs, enable Turnstile:

  1. Sign up at Cloudflare  (free).
  2. Add a new site, get the Site Key.
  3. Toggle Turnstile on in the widget settings, paste the Site Key.
  4. The widget loads the Turnstile script and shows a small invisible challenge before submission.

The challenge is invisible to legitimate users on most browsers; bots fail it silently and submissions are rejected with turnstile_failed.

Live preview

The right pane in the settings page shows a faithful preview of how the widget will look on a visitor’s site. It updates the moment you change theme color, copy, or toggle form fields. Use it to nail the look without redeploying anything.

What you CAN’T customize (yet)

These are deliberate limits in v1:

  • Form layout — fields appear in a fixed order (name → phone → message). No multi-step forms.
  • Custom CSS / HTML overrides on the form body
  • Multiple widget configs per user (one widget per account)
  • A/B testing variants
  • Meta CAPI / GA4 / GTM event firing on submission

If any of these are blockers, contact support — we prioritise customer requests for the v2 spec.