Overview

Dprime Woo Currency Switcher adds a currency switcher to your WooCommerce store. Visitors can choose from the currencies you configure, and prices, shipping rates, and fixed-amount coupons are converted using your manual exchange rates.

Before you start

WordPress 6.4 or newer
PHP 8.2 or newer
WooCommerce must be active

Installation

Install and activate the plugin.
Your WooCommerce base currency is automatically added and kept as the default currency with exchange rate 1.
Go to Dprime > Woo Currency Switcher and add the currencies you want to support.
Set the manual exchange rate for each currency relative to your WooCommerce base currency.
Place the switcher using the [dprime_currency_switcher] shortcode or the Dprime Currency Switcher widget.

Using the plugin

Manual exchange rates with no third-party API dependency
Free shipping minimum amounts convert with the active currency, so a threshold set in the base currency unlocks at the equivalent amount in every currency
TranslatePress integration: set per-language custom labels and symbols for each currency
Per-currency formatting for decimals, symbol position, separators, labels, and symbols
Price rounding modes: none, up, down, or nearest
Currency switcher via shortcode, widget, or URL parameter
Shortcode-level overrides for layout, appearance, labels, colours, radius, font, and custom classes
Toggle layout that shows one currency and switches to the next currency on click
30-day cookie persistence so customers stay in their chosen currency
Order metadata tracks the currency code and exchange rate used at checkout
Dropdown, pills, radio, select, buttons, and toggle layouts
Drag to reorder currencies in the switcher

Shortcodes

Use these in the WordPress editor, a shortcode block, or a compatible page builder.

[dprime_currency_switcher]

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dpcs-active.dpcs-arrow.dpcs-btn.dpcs-code.dpcs-dropdown.dpcs-flag.dpcs-layout-buttons.dpcs-layout-pills.dpcs-layout-radio.dpcs-layout-select.dpcs-layout-toggle.dpcs-native-select.dpcs-option.dpcs-pill.dpcs-radio-item.dpcs-selected.dpcs-switcher.dpcs-symbol.dpcs-toggle-one

Works with

These combinations are tested together in the current public releases.

AI Smart Woo Chatbot: Store-chat prices use the selected storefront currency

Data and cleanup

4 WordPress settings
Database table: your WordPress table prefix + wc_orders_meta
External service: FlagCDN

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

Confirm the required WordPress, PHP, and companion-plugin versions above.
Save the plugin settings again, then repeat the exact action that failed.
Clear page, object, and browser caches when the issue affects front-end output.
Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Frequently asked questions

How do I show the default switcher?

Use [dprime_currency_switcher].

How do I use the new toggle layout?

Use [dprime_currency_switcher layout="toggle"]. The switcher shows the active currency only. Clicking it switches to the next enabled currency in your configured order.

Can each shortcode have its own appearance?

Yes. You can use attributes such as layout, appearance, show_flags, show_code, show_symbol, bg, text, accent, border, radius, font, and class. Example: [dprime_currency_switcher layout="pills" appearance="dark" show_symbol="0"] Example: [dprime_currency_switcher layout="toggle" appearance="outline" accent="#134E8E" radius="14"]

Does it work with TranslatePress?

Yes. When TranslatePress is active, each currency row in the Currencies tab shows a translate button. Use it to enter the custom label and custom symbol for every TranslatePress language. The switcher and product prices then show the values matching the visitor's current language. Values you set here are output with data-no-translation so TranslatePress does not machine-translate over them.

Can customers switch with a URL parameter?

Yes. Use ?currency=EUR or any enabled currency code.

Updates and access

Download the complete current package directly from Dprime Plugins. Install Dprime Core to receive eligible automatic updates and move older Dprime update addresses onto the current service.

Woo Currency Switcher help file