# Multi-Currency Display

{% hint style="info" %}
Multi-Currency Display is a **PRO** feature of China Payments Plugin.
{% endhint %}

## Overview

The Multi-Currency Display feature shows prices in both your store's default currency and Chinese Yuan (¥ CNY) throughout the WooCommerce shopping experience. This helps Chinese customers understand pricing instantly without needing to manually convert currencies.

## How It Works

When enabled, a CNY equivalent price is displayed alongside every price on your store:

* **Shop pages** — Product prices show both currencies
* **Product pages** — Main price and any sale prices include CNY
* **Cart page** — Line item totals and cart totals show CNY equivalents
* **Checkout page** — Order summary displays both currencies

### Example Display

A product priced at **$100.00 USD** might display as:

> $100.00 USD (≈ ¥725.00 CNY)

The exact CNY amount depends on the current exchange rate.

## Exchange Rate

The CNY conversion uses a real-time exchange rate API. The rate is updated automatically to ensure accurate pricing.

{% hint style="success" %}
You don't need to manually set or update exchange rates — this is handled automatically by the plugin.
{% endhint %}

## How to Enable

1. Go to **China Payments Plugin** → **Optimizations** tab.
2. Toggle **Multi-Currency Display** to **On**.
3. Save settings.

The CNY prices will appear immediately across your store.

{% hint style="info" %}
Multi-Currency Display works independently of Chinese Localization — you can enable one or both features based on your needs.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chinapaymentsplugin.com/checkout-optimizations-pro/checkout-optimizations/multi-currency-display.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
