Currency Converter Widget

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

1. Upload the currency-converter-widget folder to /wp-content/plugins/
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to Settings > Currency Converter to customize defaults
4. Use the Gutenberg block or shortcode to add the widget

1. 

   Widget Compact Style - Light Theme

2. 

   Widget Mini Chart Style - With historical data

3. 

   Multi Currency Converter

4. 

   Admin Settings Dashboard

5. 

   Gutenberg Block Editor - Block Selection

6. 

   Gutenberg Block Editor - Settings Panel

4.2.0

• Added: “All Widget Styles” live gallery on the settings dashboard — every style rendered with live rates, each shown in a different accent color so you can see all eleven at a glance and copy the shortcode for the one you want

4.1.2

• Fixed: Smoother live preview in the admin when switching widget styles (no more resize flicker)

4.1.1

• Fixed: Block editor preview now displays the widget at its true size (removed the extra empty space below the widget)

4.1.0

• Added: Custom accent color — choose any hex color in addition to the preset swatches, in both the Advanced Builder and the WordPress dashboard
• Improved: Generated shortcode now carries your accent color when it differs from the default

4.0.1

• Fixed: Embed code now properly reflects all settings changes (theme, accent color, style, size, decimals)
• Fixed: Currency flag images now display correctly in admin dashboard currency pills
• Fixed: Multi-Expandable base currency dropdown now syncs with Add Currency Dropdown setting
• Fixed: Widget flags no longer show blank for currencies outside the dropdown preset

4.0.0

• Complete rebuild with new modern widget engine
• Added 11 beautiful widget styles
• Added native Gutenberg block support
• Added multi-language support (78 languages)
• Added historical rate charts
• Added number format options
• Added decimal precision control
• New admin dashboard with live preview
• Performance improvements
• Backwards compatible with legacy [currency_bcc] shortcode
• Backwards compatible with legacy sidebar widget

3.0.3

• Bug fixes and improvements

2.0.0

• Added dark mode support
• Added more currency options
• Improved mobile responsiveness

1.0.0

• Initial release