> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# lead Event

> Track when a visitor submits a lead form

Fires when a visitor submits a lead form. This is the primary conversion event for lead generation businesses and is used to track form submissions, newsletter signups, and inquiries.

<Note>
  **Shopify:** Tracked via form hooks when using compatible form/popup apps. Manual implementation may be required for custom forms.
</Note>

## JavaScript

```javascript theme={null}
window._upstack('track', 'lead', {
  source: 'contact_form',
  email: 'prospect@example.com',
  value: 150.00,
  currency: 'USD'
});
```

Newsletter signup:

```javascript theme={null}
window._upstack('track', 'lead', {
  source: 'newsletter_popup',
  email: 'subscriber@example.com'
});
```

## Properties

| Property | Type   | Required | Description                 |
| -------- | ------ | -------- | --------------------------- |
| source   | string | No       | Form or campaign identifier |
| email    | string | No       | Lead's email address        |
| value    | number | No       | Estimated lead value        |
| currency | string | No       | ISO 4217 currency code      |

## When to Fire

* Contact form submission
* Newsletter signup
* Quote request submission
* Product inquiry

## Related Events

* [subscribe](/pixel/events/subscribe) — For marketing opt-ins specifically
* [contact](/pixel/events/contact) — For contact form submissions
* [complete\_registration](/pixel/events/complete-registration) — For account signups