sendEvent()

wf.sendEvent(eventName, options?)

Trigger a custom goal to track conversions on your Webflow 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);

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