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

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 – 13 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 (300×180) – Default balanced style
6. Mini Chart (250×260) – With historical rate chart
7. Multi Expandable (300×320) – Multiple currency converter
8. Multi Fixed (300×300) – Fixed multi-currency view
9. Rates Compact (250×320) – 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 – English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese, Arabic

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 (en, es, fr, de, it, pt, pt-BR, ru, ja, ko, zh-CN, zh-TW, ar)
• 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)

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.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 (50+ 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