XeroWP
Currency Converter Widget
Currency Converter Widget

Currency Converter Widget

4.9/5 (88 ratings) 2K+ active installs Updated Aug 26, 2026
currency calculatorcurrency converterexchange ratesforexmoney converter
Download v4.2.0 Plugin Website
Widget Compact Style - Light Theme

Widget Compact Style - Light Theme

Currency Converter Widget is the easiest way to add a professional currency converter to your WordPress site. Powered by Currency.wiki, it offers real-time exchange rates for 170+ world currencies.

View Full Documentation

Convert currencies on the go with our free Android app: Currency Converter App

Key Features

  • 11 Widget Styles – Mini, Square, Tall, Inline, Compact, Mini Chart, Multi Currency, and more
  • 170+ Currencies – All major world currencies with live exchange rates
  • Gutenberg Block – Native WordPress block editor support
  • Shortcode Support – Use [currencywiki_converter] anywhere
  • Customizable – Themes, colors, languages, and display options
  • Responsive – Works perfectly on all devices
  • Fast & Lightweight – Loads asynchronously, no impact on page speed
  • Multi-language – 78 languages supported
  • Historical Charts – Show rate history (selected styles)

Widget Styles

  1. Mini (250×140) – Minimal footprint
  2. Square (250×250) – Perfect for sidebars
  3. Tall (200×280) – Vertical layout
  4. Inline (480×56) – Single line, great for headers
  5. Compact (280×200) – Default balanced style
  6. Mini Chart (250×260) – With historical rate chart
  7. Multi Expandable (300×400) – Multiple currency converter
  8. Multi Fixed (300×340) – Fixed multi-currency view
  9. Rates Compact (220×300) – Exchange rates table
  10. Rates Viewer (300×500) – Full rates display
  11. Rates Viewer Compact (300×400) – Compact rates table

Customization Options

  • Theme – Light, Dark, or Auto (system preference)
  • Accent Colors – Blue, Green, Purple, Red, Orange, Slate
  • Default Currencies – Set from/to currencies
  • Display Options – Flags, labels, swap button, branding
  • Number Format – US, European, French, Swiss styles
  • Decimal Places – 0 to 6 decimal precision
  • Lock Currencies – Prevent user changes
  • Language – 78 languages including English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese, Arabic, Hindi, Thai, Vietnamese, Turkish, Polish, Dutch, Swedish, and many more

Usage

Gutenberg Block:
Search for “Currency Converter” in the block inserter and customize in the sidebar.

Shortcode:
[currencywiki_converter]

Short Alias:
[currencywiki]

With Options:
[currencywiki_converter style=”compact” theme=”light” from=”USD” to=”EUR” amount=”100″]

All Shortcode Attributes:

  • style – Widget style (mini, square, tall, inline, compact, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact)
  • theme – Theme (auto, light, dark)
  • accent – Accent color hex without # (2563eb, 059669, 7c3aed, dc2626, ea580c, 475569)
  • from – Source currency code (USD, EUR, GBP, etc.)
  • to – Target currency code
  • amount – Default amount
  • lang – Language code – 78 supported (en, es, fr, de, it, pt, pt-br, ru, ja, ko, zh, zh-tw, ar, hi, th, vi, tr, pl, nl, sv, and more)
  • flags – Show flags (1/0)
  • labels – Show labels (1/0)
  • swap – Show swap button (1/0)
  • branding – Show branding (1/0)
  • lock – Lock currency selection (1/0)
  • format – Number format (auto, en-US, de-DE, fr-FR, de-CH)
  • decimals – Decimal places (0-6)

External services

This plugin relies on an external service to render the widget and to supply live exchange rates: Currency.Wiki, operated by CurrencyWiki Technologies LLC.

What the service is and what it is used for

The widget is drawn by a small JavaScript embed hosted at widget.currency.wiki. Live exchange rates (and, for the chart styles, historical data) are read from api.currency.wiki, and currency flag images are loaded from cdn.currency.wiki. The plugin does not bundle the widget, the rates, or the flag images; it builds an embed URL and loads them from the service. This is what keeps the plugin small and lets exchange rates stay current without a plugin update.

What data is sent, and when

  • On every page view where the widget is displayed, the visitor’s browser loads the widget from https://widget.currency.wiki/v3/ — either the script.js injector or the /v3/embed iframe, depending on the embed method you chose. To show live numbers it then requests current rates, and for chart styles historical data, from https://api.currency.wiki, and flag images from https://cdn.currency.wiki/flags/. These requests carry the display settings you configured — currency pair, amount, style, theme, accent color, language, and similar display options — as URL parameters. As with any web request, the visitor’s IP address and user agent are visible to the server.
  • No personal data is collected, and no cookies are set. Exchange rates and flags are public reference data; nothing about your visitor is sent beyond the ordinary contents of an HTTP request.
  • In the WordPress admin, live previews are loaded from https://widget.currency.wiki/v3/embed (flagged preview=1 so they are not counted as a site using the widget) on two screens: the settings dashboard, which shows a live preview and an “All Widget Styles” gallery, and the block editor, which previews the block as you configure it. These send the same display settings listed above; no personal data is sent from the admin.

Terms and privacy

  • Terms of Service: https://currency.wiki/terms-of-service
  • Privacy Policy: https://currency.wiki/privacy-policy