SkySwitcher - Multicurrency Currency Switcher for WooCommerce

SkySwitcher is a WordPress plugin that lets WooCommerce store owners display product prices in multiple currencies using live exchange rates. Customers can seamlessly switch between currencies using a dropdown, floating widget, shortcode, Elementor widget, or Gutenberg block—making international shopping feel local.

It’s designed for WooCommerce merchants who sell to customers around the world. Whether you want to offer a handful of popular currencies or a full suite of global options, SkySwitcher handles the conversion automatically and keeps your prices accurate with synced rates from exchangerate-api.com.

The free version supports up to 5 currencies, while the Pro version unlocks unlimited currencies plus advanced features like auto-syncing exchange rates, visitor geo-targeting with a popup, and analytics to see which currencies your customers prefer.

Exchange Rates Management

What It Does

This feature lets you sync live exchange rates from a third‑party provider to keep your store prices current. You can also enter custom rates for any currency, add a markup to cover bank fees, and personalize currency symbols.

How to Use It

1. Go to Settings → Currency Switcher → Exchange Rates tab.
2. Click Sync Exchange Rates to pull the latest live rates for your store’s base currency.
3. (Optional) For any enabled currency:
   • Enter a Manual Exchange Rate to override the synced rate.
   • Set an Exchange Fee (%) to apply a markup.
   • Change the Custom Symbol (for example, “US$” instead of “$”).
4. Click Save Currency Settings to store your changes.

Settings & Options

Tips & Best Practices

• Sync regularly – Live rates fluctuate, so click the sync button frequently to keep displayed prices accurate.
• Use manual rates when needed – If your provider is unavailable or you need a fixed rate, enter a manual value to ensure consistency.
• Set realistic exchange fees – Add a small percentage markup to absorb actual bank or payment processor costs without surprising customers.
• Custom symbols improve clarity – Differentiate currencies at a glance by using unique symbols (e.g., “€” vs “€ EURO”).

Currency Selection

What It Does

Choose which currencies to make available in the currency switcher dropdown on your site. The free version allows up to 5 currencies, while Pro unlocks unlimited selection.

How to Use It

1. Go to Settings → Currency Switcher and open the Add Currency tab.
2. Browse the list of available currencies, or use the search field to filter by country name, currency name, or code.
3. Check the boxes next to the currencies you want to offer.
4. Click Save Currencies to apply your selection.
5. The chosen currencies now appear in the switcher on your site's frontend.

Settings & Options

Tips & Best Practices

• Keep an eye on the free version limit of 5 currencies. Upgrade to Pro to offer unlimited currencies.
• Use the search field to quickly find specific currencies instead of scrolling through the full list.
• The Select All button only selects up to the free limit – review your selection before saving.
• Offer only the currencies your customers are likely to use to keep the switcher clean and focused.

Payment Gateway Rules by Currency

What It Does

This feature lets you restrict which payment gateways appear at checkout based on the customer’s selected currency. You can hide specific gateways for each enabled currency, ensuring only relevant options are shown for that currency.

How to Use It

1. Go to Settings → Currency Switcher → Payment Gateways tab.
2. For each enabled currency, check the box next to each payment gateway you want to hide at checkout.
3. Click Save Gateway Rules to apply your changes.
4. When a customer chooses a currency on the checkout page, any hidden gateways for that currency will no longer be available.

Settings & Options

Tips & Best Practices

• Plan gateway restrictions based on which payment methods are most common or trusted in the currency’s region.
• Always click Save Gateway Rules after making changes; unsaved changes won’t take effect.
• Test the checkout process with different currencies to confirm the correct gateways are shown or hidden.
• Use this feature to avoid showing payment methods that aren’t supported or practical for a particular currency.

Shortcode and Display Customization

What It Does

This feature lets you control exactly how the currency switcher dropdown appears on your site. You can choose to show or hide country flags, rearrange the order of currency symbol, code, or name, set the dropdown size, and even attach it automatically to a menu.

How to Use It

1. Go to Settings → Currency Switcher and open the Shortcode tab.
2. Use the Show flag toggle to display or hide flags next to each currency.
3. Drag and drop the display elements (symbol, code, name) to set the order you prefer.
4. Enter your desired Box Width and Box Height in pixels to resize the dropdown.
5. If you want the switcher to appear in a navigation menu, select a menu from Menu Bar Integration dropdown.
6. Click Save Settings to apply your changes.
7. To place the switcher manually on a page or post, use the shortcode provided on this screen.

Settings & Options

Tips & Best Practices

• Test your order – After rearranging the format order, preview the dropdown to ensure it shows the most important info first (e.g., symbol before code).
• Mind the menu integration – If you enable menu integration, the switcher will automatically appear at the end of that menu. You don’t need to place the shortcode manually.
• Keep dimensions consistent – Choose a width and height that fit your site’s design without looking too big or too small. Start with the defaults and adjust from there.
• Use the shortcode for custom placement – For more control, embed the shortcode in a widget, post, or page rather than relying on menu integration.

Floating Currency Widget

What It Does

The Floating Currency Widget adds a currency switcher overlay that stays fixed to the side of every page on your site. Customers can change the displayed currency from anywhere without needing to scroll or navigate to a separate menu. All price updates happen instantly through AJAX, so the page doesn’t reload.

How to Use It

1. Go to Settings → Currency Switcher → Floating Widget tab.
2. Check the Enable floating widget checkbox to turn the widget on.
3. Configure the alignment, display mode, and style options to match your site’s design.
4. Click Save Floating Widget Settings.
5. The floating widget now appears on every frontend page.
6. When a customer clicks a currency in the widget, the store’s prices switch to that currency automatically.

Settings & Options

Tips & Best Practices

• Choose a background color and transparency that contrast well with your site design so the widget remains visible but not distracting.
• If your store supports many currencies, using Display Mode: Code (e.g., USD, EUR) can be clearer for customers than small flag icons.
• Test the widget on mobile devices to ensure the chosen alignment doesn’t interfere with navigation or touch targets.
• The floating widget works best as a quick-access tool; consider keeping your main currency selector in the header or footer for customers who prefer a more traditional location.

Setup Wizard (Onboarding)

What It Does

The Setup Wizard provides a guided 5‑step process to help you quickly configure the currency switcher for the first time. You can sync exchange rates, choose which currencies to enable, customize display options, and turn on the floating widget—all from a single walk‑through.

How to Use It

1. Launch the wizard.
   The wizard appears automatically when you activate the plugin for the first time. If you need to start it again later, click the Run Setup Wizard link on the Currency Switcher settings page.

2. Step 1 – Select currencies.
   The wizard automatically syncs the latest exchange rates. From the list of available currencies, select the ones you want to use on your site.

3. Step 2 – Review & override rates.
   Review the synced exchange rates. If needed, enter custom manual rates for any individual currency.

4. Step 3 – Choose a display method.
   Decide how customers will switch currencies:

   • Shortcode – Provides a currency selector that you place anywhere on your site (you can configure flags, format order, box width/height).
   • Floating Widget – Shows a floating button on the front end (you can set alignment, display mode, colors, and opacity).

5. Step 4 – Review (Pro upsell).
   See an optional upgrade offer and confirm your choices so far. Click Continue to move forward.

6. Step 5 – Summary & finish.
   Review a summary of your configuration. If you chose the shortcode method, copy the shortcode shown. Click Go to Dashboard to exit the wizard and start using the currency switcher.

Settings & Options

Tips & Best Practices

• Complete the wizard first – Letting the wizard walk you through every setting ensures nothing is missed, especially rate syncing and display configuration.
• Use manual rates for fixed prices – If you need to lock a specific exchange rate for a currency, enter it manually in Step 2.
• Choose the display method that fits your layout – The shortcode gives you precise placement control, while the floating widget is easier to activate without editing your theme.
• Copy the shortcode in Step 5 – If you selected the shortcode method, copy the code provided at the summary screen so you can paste it into any page, post, or widget.

Individual Product Currency Prices

What It Does

This feature allows you to set a fixed price in each enabled currency for your simple products and product variations. When a fixed price is entered, it overrides the automatically calculated exchange rate conversion for that product or variation.

How to Use It

1. Go to WooCommerce → Products and edit the product you want to adjust.
2. In the Product Data section, locate the Manual Currency Prices area.
   • For simple products, this appears in the General tab.
   • For variable products, expand a variation in the Variations tab to find its manual price fields.
3. For each enabled currency, enter a fixed price in the provided field. Leave the field empty to use the automatically converted rate instead.
4. Click Update or Save to store your changes.
5. When a customer selects that currency on the front end, the fixed price you set will be displayed instead of the converted price.

Settings & Options

Tips & Best Practices

• Leave a currency price field empty if you want the system to apply the automatic exchange rate conversion for that currency.
• Use fixed prices to maintain consistent margins in markets where exchange rates fluctuate significantly.
• For variable products, remember to set a fixed price for each variation individually if needed.
• Periodically review your manual prices to ensure they stay aligned with your business goals and any market changes.

Elementor Currency Switcher Widget

What It Does

The Elementor Currency Switcher Widget inserts a currency converter into any page built with Elementor. It comes with configurable display options so you can choose what information your visitors see when switching currencies.

How to Use It

1. In the Elementor editor, search for “Currency Switcher” in the widget panel.
2. Drag the widget onto your desired section of the page.
3. In the widget settings panel, toggle the display options and set the dimensions according to your preferences.
4. Publish or update the page to make the currency switcher active on the frontend.

Settings & Options

Tips & Best Practices

• Use the Show Flag toggle to add visual recognition for currencies, but consider page performance if you use many flags.
• Adjust Box Width and Box Height to ensure the dropdown fits elegantly within your page layout.
• Show the currency symbol or code for clarity, especially on international‑facing pages.
• Preview your changes in the Elementor editor before publishing to confirm the switcher appears as intended.

Gutenberg Currency Switcher Block

What It Does

This block adds a currency converter directly to any page or post using the WordPress block editor. It lets you control which visual elements (flag, symbol, name, currency code) are shown and adjust the size of the dropdown so it fits your site’s design.

How to Use It

1. In the block editor, search for the Currency Switcher block and add it to your page or post.
2. In the block settings panel on the right, use the toggles to show or hide the flag, symbol, currency name, or currency code.
3. Adjust the width and height of the dropdown using the range sliders.
4. Publish or update the page. The block will display your customized currency converter on the live site.

Settings & Options

Tips & Best Practices

• Enable flags or symbols to help visitors quickly identify currencies without reading names.
• Adjust the dropdown width and height so the converter blends naturally with your page layout.
• Preview the page before publishing to ensure the chosen combination of displayed elements looks clean and readable.
• If your audience includes international users, consider showing both the name and the currency code for clarity.

Auto-Sync Exchange Rates (Pro)

What It Does

Auto-Sync Exchange Rates (Pro) keeps your exchange rates up to date automatically by syncing on a schedule using WordPress background tasks. Once enabled, the feature runs at the interval you choose, so you never have to manually refresh rates. This feature requires an active Pro license.

How to Use It

1. Activate your Pro license on the License tab of the Settings page.
2. Navigate to Settings → Currency Switcher and open the Auto-Sync tab (visible only with a Pro license).
3. Check the Enable Automated Syncing box to turn on automatic updates.
4. Select your preferred sync frequency from the available options (Hourly, Every 12 Hours, Daily, or Weekly).
5. Click Save Sync Settings to apply your changes.

Settings & Options

Tips & Best Practices

• Make sure your Pro license is active before setting up auto-sync – the feature won’t work without a valid license.
• Choose a sync frequency that matches how often your store’s rates need to be accurate. For most cases, Daily is a good balance between freshness and system load.
• If you change your sync frequency later, simply return to the Auto-Sync tab, update the selection, and save.
• Automatic syncing relies on WordPress cron. Confirm that cron jobs are running on your server to ensure the schedule executes reliably.

Visitor Geo-Targeting (Pro)

What It Does

Visitor Geo‑Targeting automatically detects the country of each visitor using IP geolocation. If their local currency is available in your store and is different from the one currently displayed, a popup will appear suggesting they switch to their local currency. This feature helps create a more personalized shopping experience and can increase conversion rates by showing prices in the visitor’s own currency.

How to Use It

1. Activate your Pro license – Make sure you have an active Pro license for the plugin.
2. Go to the Geo Targeting tab – From your WordPress admin, navigate to Settings → Currency Switcher → Geo Targeting.
3. Enable the popup – Check the Enable geo targeting popup checkbox.
4. Save your settings – Click the Save Geo Targeting Settings button.
5. Visit your site as a test – When a visitor loads any page, the plugin automatically fetches their country via the ipapi.co service.
6. See the popup in action – If the visitor’s local currency is in your enabled list and differs from the current currency, a popup will ask: “Would you like to switch to [local currency]?”
7. Handle the visitor’s choice – Clicking Yes immediately switches the currency and reloads the page. Clicking No dismisses the popup.
8. Remember the decision – The visitor’s choice is remembered for 30 days (if they clicked Yes) or 1 day (if they clicked No) via cookies.

Settings & Options

Tips & Best Practices

• Check your license first – The Geo‑Targeting feature only works with an active Pro license. Verify your license status on the plugin’s license management page before configuring this setting.
• Enable the currencies you want to suggest – The popup only appears for currencies you have already enabled in the main currency switcher settings. Make sure all relevant local currencies are added and active.
• Understand the cookie duration – Visitors who agree to switch will not be prompted again for 30 days. Those who decline will be reminded after 1 day. Keep this in mind if you plan to promote different currency offers.
• Be aware of external service dependency – This feature relies on the ipapi.co service for IP geolocation. Ensure your server can make outbound requests to that service, and consider that occasional downtime may affect detection.

Currency Switcher Analytics (Pro)

What It Does

This feature tracks how many times visitors switch to each currency, giving you insight into which currencies are most popular on your site. It’s only available with an active Pro license.

How to Use It

1. Activate your Pro license – Make sure a valid Pro license is active on your site.
2. Navigate to the Analytics tab – Go to Settings → Currency Switcher → Analytics.
3. View the analytics table – You’ll see a table listing each currency alongside the number of times customers have switched to it.
4. Reset the data (optional) – To start fresh, click the Clear Analytics Data button. All counts will be reset to zero.

Note: Every time a visitor switches a currency (triggered by the currency switcher action), the counter for that currency is automatically incremented.

Settings & Options

This feature has no configurable settings. The analytics table and the clear‑data action are all you’ll see on the Analytics tab.

Tips & Best Practices

• Use the analytics to stock the right currencies – Popular currencies can indicate which regions are most interested in your products. Consider offering additional payment options or promotions in those currencies.
• Clear data periodically – If you run seasonal promotions or update your pricing, resetting the analytics helps you measure the impact of those changes.
• Combine with other Pro features – Currency Switcher Analytics works alongside other Pro tools to give you a fuller picture of your international customers’ behavior.
• Check data after major site changes – After redesigns or plugin updates, reviewing currency switch patterns can help you spot any unexpected changes in visitor behavior.

Pro License Management

What It Does

The Pro License Management feature lets you activate, deactivate, and verify your SkySwitcher Pro license key. Once a valid license is activated, premium features such as auto-sync, geo-targeting, analytics, and unlimited currencies are unlocked on your site.

How to Use It

1. Go to Settings → Currency Switcher → License tab.
2. If no license is currently active, enter your Pro license key into the text field.
3. Click Activate License. The plugin sends an API request to validate your key.
4. If the key is valid, premium features are automatically unlocked.
5. To disable the license on this site, click Deactivate License.
6. To re-check the license’s validity at any time, click Verify License Status.

Settings & Options

Tips & Best Practices

• Make sure you copy the license key exactly as provided – it is case-sensitive.
• Use Verify License Status if you ever suspect your license has been revoked or expired.
• Deactivate your license before moving or transferring the site to a new domain to avoid activation issues.
• Keep a record of your license key in a safe place for future reactivations.