> ## 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.

# trial_started Event

> Track when a visitor begins a free trial

Fires when a visitor begins a free trial. This is a key conversion event for SaaS and subscription businesses to track trial signups and optimize acquisition campaigns.

<Note>
  **Shopify:** Manual implementation required. Integrate with your subscription/trial system.
</Note>

## JavaScript

```javascript theme={null}
window._upstack('track', 'trial_started', {
  planName: 'Premium Plan',
  trialDays: 14,
  value: 49.99,
  currency: 'USD'
});
```

## Properties

| Property  | Type   | Required | Description                |
| --------- | ------ | -------- | -------------------------- |
| planName  | string | No       | Trial plan or product name |
| trialDays | number | No       | Trial duration in days     |
| value     | number | No       | Plan value after trial     |
| currency  | string | No       | ISO 4217 currency code     |

## When to Fire

* Trial signup confirmation
* Trial activation

## Related Events

* [sign\_up](/pixel/events/sign-up) — For account creation
* [purchase](/pixel/events/purchase) — When trial converts to paid