From b3e832ecdf44618170fe361c59a1eed624a9b084 Mon Sep 17 00:00:00 2001 From: Michael Bromley Date: Wed, 15 Nov 2023 11:16:30 +0100 Subject: [PATCH] docs: Add docs on multiple currency support. --- docs/docs/guides/core-concepts/money/index.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/docs/guides/core-concepts/money/index.mdx b/docs/docs/guides/core-concepts/money/index.mdx index 1562c740d8..eb64394a6c 100644 --- a/docs/docs/guides/core-concepts/money/index.mdx +++ b/docs/docs/guides/core-concepts/money/index.mdx @@ -77,6 +77,16 @@ If you are building an Admin UI extension, you can use the built-in [`LocaleCurr ``` +## Support for multiple currencies + +Vendure supports multiple currencies out-of-the-box. The available currencies must first be set at the Channel level +(see the [Channels, Currencies & Prices section](/guides/core-concepts/channels/#channels-currencies--prices)), and then +a price may be set on a `ProductVariant` in each of the available currencies. + +When using multiple currencies, the [ProductVariantPriceSelectionStrategy](/reference/typescript-api/configuration/product-variant-price-selection-strategy/) +is used to determine which of the available prices to return when fetching the details of a `ProductVariant`. The default strategy +is to return the price in the currency of the current session request context, which is determined firstly by any `?currencyCode=XXX` query parameter +on the request, and secondly by the `defaultCurrencyCode` of the Channel. ## The GraphQL `Money` scalar