sendEvent()

wf.sendEvent(eventName, options?)

Trigger a custom goal event to track conversions on your site.

Syntax

1
wf.sendEvent(eventName: string)

1
wf.sendEvent(eventName: string, options: { value: number | string })

Parameters

• eventName (required): string — The name of the custom event you created in your custom goal. Must be 40 printable ASCII characters or fewer, and cannot contain spaces.

• options (optional): { value: number | string } — An object containing a value property for tracking monetary or numeric values with the conversion.

1
Number.parseFloat(rawValue).toFixed(2);

Use with Google Tag Manager

If you’re using Google Tag Manager (GTM) and already have triggers set up for actions you want to track, you can create a custom HTML tag that calls wf.sendEvent():

1
<script>
2
wf.ready(function() {
3
    wf.sendEvent('form_submitted');
4
});
5
</script>

Then attach this tag to an existing GTM trigger (e.g., a “Form Submission” trigger you’re already using for other tracking).

Examples

Basic usage

Track a simple on-site conversion:

1
wf.ready(function() {
2
    wf.sendEvent('form_submitted');
3
});

With a value

Track an on-site conversion with an associated monetary value:

1
wf.ready(function() {
2
    wf.sendEvent('purchase', { value: 149.99 });
3
});

Recording dynamic values

Track values that vary based on user action, such as a shopping cart total:

1
wf.ready(function() {
2
    var eventName = 'purchase';
3
    var price = document.getElementById('total_price').value;
4
    wf.sendEvent(eventName, { value: price });
5
});

Returns

This method doesn’t return a value. The event is sent to Webflow and recorded in your optimization results.

FAQs