The Multiple Currency Widget in WpRentals allows users to switch between different currencies when viewing property prices on the site.
💡 Note: It does not convert payment currencies for booking (payment is always processed in your main currency) – it is for display purposes only.
How It Works
-
The widget converts displayed property prices based on the exchange rates you manually define in the theme options.
-
It uses session/cookie storage, so when a user selects a currency, it persists across the site.
Price & Currency Options for Multi Currency
This section allows you to configure how prices and currency appear across the site, including setup for the multi-currency dropdown widget.
Currency Code for Multi Currency Widget
- Match your site’s base currency with the exchange rates provider
- Enable correct syncing when using automatic exchange rate updates
Make sure to use valid ISO 4217 currency codes.
See full list: http://www.xe.com/iso4217.php
Each price will be originally displayed using the main currency you set in Theme Options -> Price & Currency
Enable auto loading of exchange rates from free.currencyconverterapi.com (1 time per day)?
To automatically update currency exchange values once per day, you must configure all three of the following settings correctly:
- You must enable Enable auto loading of exchange rates from free.currencyconverterapi.com (1 time per day)? AND add your Currencyconverterapi.com Api Key
- Get the free api key from here https://free.currencyconverterapi.com/free-api-key and add it in Theme Options
- Set the Currency Code and Label according to International Standards http://www.xe.com/iso4217.php
Add Currencies for Multi Currency Widget
In theme options, add each currency with:
- Currency Code (e.g., GBP)
- Currency Label (e.g., £)
- Currency Value (e.g., 0.73 if 1 USD = 0.73 GBP)
- Position of symbol (before or after price)
How to add the widget
- Go to Appearance > Widgets.
- Locate the widget called “Wp estate – Multiple Currency Widget”.
- Add it to a widget area like:
- Header Widget Area
- Top Bar Left/Right
- Sidebar
- Footer Column
Classic Widgets View
Gutenberg Widgets View
Front-End Behavior
- The user selects a currency from the dropdown.
- Property prices across the site (listings, search results, single property pages) are converted instantly.
- The conversion uses your manually set exchange rates.
- Prices revert to the base currency at checkout or invoice level.
Cookies & Caching Notes
- User-selected currency is stored in cookies.
- Some caching plugins may conflict with this feature and display incorrect prices.
✅ Refer to this guide for using caching with multicurrency:
How to use a cache plugin with the Multi-Currency widget dropdown