Installation guide for affiliates and internal teams building landing / sales pages.
The widget combines two things in one flow: a lead finder and a personalized email sample generator. A visitor enters their own website URL and an email address. Wholix analyzes the website, finds 3 matching decision-makers at relevant target companies, and generates a complete 3-step outreach email sequence for each lead — fully personalized to the visitor's offer and the lead's context. The visitor receives a link to the full results in their inbox. You get a qualified lead, attributed to you via your affiliate ID.
Where to paste the snippet depends on the layout you choose:
data-placement (see step 3) to mount it elsewhere.</body> tag so it doesn't block page rendering.| Attribute | Description |
|---|---|
data-affiliate-id | Your unique affiliate identifier. Used for attribution and reporting. Ask Wholix if you don't have one yet. |
data-locale | Language for the widget UI and the generated emails. One of: de-DE, en-US, en-GB, es-ES, fr-FR, it-IT. |
data-cta | The visible call-to-action text. For inline-form it's the headline above the form. For button it's the button label. Translate this yourself to match your page language and audience. |
data-style | Either inline-form (form embedded in the page) or button (floating button bottom-right). |
Renders a form directly in your page where the script tag is placed. When the visitor submits a URL, a modal opens asking only for their email.
<script
src="https://dev.wholix.ai/widgets/leads-and-email-samples.js"
data-affiliate-id="YOUR_AFFILIATE_ID"
data-style="inline-form"
data-locale="en-US"
data-cta="Hol dir kostenlose Leads & E-Mail-Beispiele">
</script>Live demo below ↓
Adds a fixed CTA button in the bottom-right corner of every page. When clicked, opens a modal with both URL and email inputs. Good for blogs and content sites where you want a persistent call to action.
<script
src="https://dev.wholix.ai/widgets/leads-and-email-samples.js"
data-affiliate-id="YOUR_AFFILIATE_ID"
data-style="button"
data-locale="en-US"
data-cta="Get FREE leads & sample mails">
</script>Live demo: see the orange button in the bottom-right of this page.
By default the inline form renders at the position of the script tag. To place it somewhere else on the page, give a target element an id and add data-placement:
<div id="wholix-mount"></div>
<!-- ...rest of your page... -->
<script
src="https://dev.wholix.ai/widgets/leads-and-email-samples.js"
data-affiliate-id="YOUR_AFFILIATE_ID"
data-style="inline-form"
data-placement="#wholix-mount"
data-locale="en-US"
data-cta="Get free email samples">
</script>When a visitor successfully submits the form, the widget fires a wholix:lead event on the host page. Use this to forward conversions to Google Analytics, Facebook Pixel, or your own tracking.
window.addEventListener('wholix:lead', (e) => {
console.log('Lead captured:', e.detail);
// e.detail = {
// url, email (masked), affiliate_id,
// sample_request_id, result_url
// }
// Example: Google Analytics 4
gtag('event', 'generate_lead', {
affiliate_id: e.detail.affiliate_id,
value: 1
});
});The email in the event payload is masked (e.g. v***@example.com) to avoid leaking PII to third-party trackers. The full email is only stored on Wholix servers.
The flow has two stages — a public preview and a full results page unlocked via email confirmation:
This two-stage flow gives visitors instant gratification (they see something is being generated) while protecting the most valuable content behind email verification — which is what makes the lead qualified.
The loader script is small (a few KB) and loads asynchronously. The widget itself only loads when a user interacts with it.
Not yet — the widget uses Wholix's standard look (orange primary color). Brand customization is on the roadmap.
They get a confirmation email with a link to a preview of the results. The full results are only revealed when they click the link in their inbox. This both verifies the email is real and prevents the public preview link from being shared.
It's sent to the Wholix backend with every submission and stored alongside the lead. You will be able to see your attributed leads and conversions in your Wholix affiliate dashboard (coming soon).
Contact support@wholix.ai with your affiliate ID and a link to the page where you're embedding the widget.