> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# SetCurrencies

# Package: stores

# Namespace: SiteCurrencySettings

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/stores/site-currency/set-currencies.md

## Permission Scopes:
Manage Stores: SCOPE.STORES.MANAGE-STORES

## Introduction

Sets the list of currencies that can be displayed on the site.

When you set currencies for a site, visitors can view prices in any of these currencies.
Prices are automatically converted using up-to-date exchange rates.
The supplied list completely replaces the previous currency list.

To disable currency conversion entirely, pass an empty array.

---

## REST API

### Schema

```
 Method: setCurrencies
 Description: Sets the list of currencies that can be displayed on the site.  When you set currencies for a site, visitors can view prices in any of these currencies. Prices are automatically converted using up-to-date exchange rates. The supplied list completely replaces the previous currency list.  To disable currency conversion entirely, pass an empty array.
 URL: https://www.wixapis.com/settings/v1/currencies/site
 Method: PUT
 Method parameters:
   param name: currencies | type: array<currencies> | description: List of currencies to enable for the site. This list replaces any previously configured currencies. Pass an empty array to disable currency conversion. 
              - name: code | type: string | description: Three-letter currency code, in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. 
 Return type: SetCurrenciesResponse
  EMPTY-OBJECT {}


```

### Examples

### Set Currencies
Sets the list of currencies that can be displayed on the site.

```curl
curl -X PUT \
  'https://www.wixapis.com/settings/v1/currencies/site' \
  -H 'Content-type: application/json' \
  -H 'Authorization:  <AUTH>' \
  -d '{
      "currencies": [
        {"code": "AED"},
        {"code": "AFN"},
        {"code": "AMD"}
      ]
    }'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.stores.SiteCurrencySettings.setCurrencies(options)
 Description: Sets the list of currencies that can be displayed on the site.  When you set currencies for a site, visitors can view prices in any of these currencies. Prices are automatically converted using up-to-date exchange rates. The supplied list completely replaces the previous currency list.  To disable currency conversion entirely, pass an empty array.
 Method parameters:
   param name: options | type: SetCurrenciesOptions  none 
        - name: currencies | type: array<SiteCurrency> | description: List of currencies to enable for the site. This list replaces any previously configured currencies. Pass an empty array to disable currency conversion. 
           - name: code | type: string | description: Three-letter currency code, in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. 
 Return type: PROMISE<SetCurrenciesResponse>
  EMPTY-OBJECT {}


```

### Examples

### setCurrencies
```javascript
import { siteSettings } from '@wix/currency-converter';

async function setCurrencies(options) {
  const response = await siteSettings.setCurrencies(options);
};
```

### setCurrencies (with elevated permissions)
```javascript
import { siteSettings } from '@wix/currency-converter';
import { auth } from '@wix/essentials';

async function mySetCurrenciesMethod(options) {
  const elevatedSetCurrencies = auth.elevate(siteSettings.setCurrencies);
  const response = await elevatedSetCurrencies(options);
}
```

### setCurrencies (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { siteSettings } from '@wix/currency-converter';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { siteSettings },
  // Include the auth strategy and host as relevant
});


async function setCurrencies(options) {
  const response = await myWixClient.siteSettings.setCurrencies(options);
};
```

---