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

# currency event

> The currency tracking event tells PureClarity what currency is the users preference, and thus controls what currency is returned in product recommenders. The currency code must be a valid ISO 4217 currency code. Prices in the currency must already be stored against the products as part of the data feed before sending the event.

# Currency Event

The currency tracking event tells PureClarity what currency is the user's preference, and thus controls what currency is returned in product recommenders. The currency code must be a valid ISO 4217 currency code, (e.g. "USD", "GBP" etc.). Prices in the currency must already be stored against the products as part of the data feed before sending the event.

<Note>
  This applies to client-side mode only. See [server-side documentation](/integrations/custom/api-reference/server-side/server-side) on information on how to set the currency as part of the main request model.
</Note>

PureClarity will not do exchange rate price conversion. The price for each currency supported by the site needs to be sent in the feed. See [Data Feeds](/integrations/custom/api-reference/data-feeds/overview) for more details.

If this is not sent, the default currency set against your store view will be used. Also if currency is set, only products with that currency, sent in the product feed, will be shown.

<Tip>
  If using server-side mode you will want to send this at the start of each new session if not displaying the default currency.
</Tip>

## Value Format

The currency event takes a single **string** value containing a valid ISO 4217 currency code.

**Type:** `string`

**Example values:**

* `"USD"` - US Dollar
* `"GBP"` - British Pound
* `"EUR"` - Euro
* `"CAD"` - Canadian Dollar
* `"AUD"` - Australian Dollar

## Usage

### Client-side Implementation

```javascript theme={null}
// Set currency to US Dollars
_pc("currency", "USD");

// Set currency to British Pounds
_pc("currency", "GBP");

// Set currency to Euros
_pc("currency", "EUR");
```

### When to Send

Send the currency event:

* When a user changes their currency preference on your site
* At the start of a new session if the user has a saved currency preference
* Before displaying any product recommenders with non-default currency

## Important Notes

<Warning>
  All prices for the specified currency must exist in your product feed. Products without prices for the selected currency will not be displayed in recommenders.
</Warning>

**Valid ISO 4217 Currency Codes:**
[View complete list of ISO 4217 currency codes](https://en.wikipedia.org/wiki/ISO_4217)