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

# currency

> ISO 4217 currency code. Required whenever you include value.

ISO 4217 currency code. Required whenever you include `value`.

```javascript theme={null}
window._upstack('track', 'add_to_cart', {
  value: 49.99,
  currency: 'USD'  // USD, EUR, GBP, CAD, etc.
});
```

| Type   | Required                | Events                 |
| ------ | ----------------------- | ---------------------- |
| string | Yes (when value is set) | Any event with `value` |

## Common Currency Codes

| Code  | Currency          |
| ----- | ----------------- |
| `USD` | US Dollar         |
| `EUR` | Euro              |
| `GBP` | British Pound     |
| `CAD` | Canadian Dollar   |
| `AUD` | Australian Dollar |
| `JPY` | Japanese Yen      |

## Related Properties

<CardGroup cols={2}>
  <Card title="value" icon="coins" href="/pixel/events/properties/value">
    The monetary value of the event.
  </Card>
</CardGroup>