Focused WordPress plugins for real client work.Clear licensing for 1, 5, or 100 websites

Woo Currency Switcher documentation

Help and reference for version 3.2.0.

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.

Requirements

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

Installation

  1. Install and activate the plugin.
  2. Your WooCommerce base currency is automatically added and kept as the default currency with exchange rate 1.
  3. Go to Dprime > Woo Currency Switcher and add the currencies you want to support.
  4. Set the manual exchange rate for each currency relative to your WooCommerce base currency.
  5. 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

Works with

These connections are covered by the release contract tests.

  • 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
  • Optional external service: FlagCDN

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

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

This complete free release can be downloaded directly. Install Dprime Core for automatic catalogue updates.