Configuration

Everything lives in one place: FluentCart → Settings → Multi-Currency. The settings now include a dedicated Switcher tab for global switcher defaults. Seven tabs, each with a specific job. You can also get there directly via:

/wp-admin/admin.php?page=fluent-cart#/settings/multi-currency

General

The on/off switches and basic preferences. Start here.

Multi-Currency Enabled

The master switch. Flip it to Enabled and the plugin starts working — prices convert, the switcher appears, checkout notices show up. Flip it to Disabled and everything stops, but your settings stay exactly where you left them.

Base Currency

This is the currency your store actually charges in. FluentCart processes payments in this currency. Every exchange rate is calculated relative to it. If your Stripe or PayPal is set to GBP, this should be GBP.

Default Display Currency

What currency does a brand-new visitor see? If someone lands on your site for the first time — no cookie, no account, no URL parameter — this is the currency they get. Usually you'd set this to match your base currency, but if most of your traffic comes from, say, Germany, you might default to EUR.

URL Parameter

When enabled, you can link people directly to a specific currency:

yourstore.com/shop?currency=GBP

Handy for email campaigns or regional ads. The "URL Parameter Key" field lets you change currency to something else if it conflicts with another plugin (unlikely, but possible).

Cookie Persistence

Should the plugin remember which currency a visitor picked? When enabled, their choice is saved in a browser cookie for 90 days (configurable). They come back next week — still in EUR. No need to pick again.

When disabled, every page load starts fresh from the default display currency. Most stores want this on.

Account Persistence

Separate from browser cookies, this controls whether logged-in users keep their preference in their account metadata.

• Enabled — logged-in users keep their selected currency across sessions
• Disabled — logged-in users behave like a fresh session unless another resolver wins

This is useful when you want to test or demo the site as an authenticated user without your old preference overriding the configured default display currency.

Remove Data on Uninstall

Leave this on Keep data unless you're absolutely sure you're done with the plugin. When set to Delete all, removing the plugin wipes everything — rate history, settings, saved currency preferences. There's no undo.

Currencies

This is where you build the menu of currencies your visitors can choose from.

Use the search field at the top to find currencies from FluentCart's catalogue (180+ currencies). Click one to add it to your list. Each currency in the table shows:

• Flag — the emoji flag for that country/region
• Code — the three-letter code (EUR, GBP, PLN, etc.)
• Symbol — what appears next to the price (€, £, zł)
• Decimals — how many decimal places to show (usually 2)
• Position — where the symbol goes: before the number ($100), after (100€), or with a space

You can customise:

• symbol
• decimals
• position
• decimal separator
• thousand separator

for each currency individually. Hit the red x to remove one.

Drag currencies up or down to control the order they appear in the currency switcher. The order you set here is the order your visitors see.

Switcher

This tab defines the global defaults used by switcher blocks that inherit from admin settings.

Preset

Pick the default visual treatment:

• Default
• Pill
• Minimal
• Subtle
• Glass
• Contrast

Trigger Defaults

Choose what the closed switcher button shows:

• flag
• code
• symbol
• name

Dropdown Defaults

Choose what each option row shows:

• flags
• codes
• symbols
• names
• active checkmark

Favorites and Search

You can define:

• inline search as the default search mode
• favorite currencies via comma-separated ISO codes
• whether favorites should appear first

Layout Defaults

Set the baseline behavior for inheriting blocks:

• label position
• size
• width mode
• dropdown position
• dropdown direction

Footer Context

You can enable any combination of:

• freshness badge
• exchange rate line
• checkout/base-currency note

This is useful when you want trust-building context without manually configuring every block instance.

Exchange Rates

Where the actual conversion numbers come from, how often they update, and what happens when they don't.

Rate Provider

Pick where your exchange rates come from:

The API key field only shows up when the provider needs one. For ECB, there's nothing to configure — just select it and go.

Refresh Interval

How often the plugin fetches fresh rates. Default is every 6 hours, which works for most stores. You can go as low as every hour (if you're paranoid about rate changes) or as high as once a week (if you're not).

Stale Threshold

How old a rate can get before the plugin considers it "stale" and starts warning you. Default is 24 hours. When rates go stale:

• You'll see a warning in your WordPress dashboard
• The currency switcher shows a red dot instead of green
• The stale fallback kicks in (see below)

Stale Rate Fallback

What should happen if rates are stale?

• Show base currency — safe option. Visitors see your base currency prices instead of potentially outdated conversions.
• Use last known rate — keeps showing converted prices even if the rate is old. The switcher badge makes it clear the rates aren't fresh.

Rounding Mode

After the exchange rate math, how should converted prices be rounded?

• Round half up — the standard. €12.345 becomes €12.35. This is what you want 99% of the time.
• Round half down — rounds .5 down instead of up
• Ceil — always rounds up
• Floor — always rounds down
• None — truncates to the currency's decimal places without rounding (33.337 → 33.33)

Current Rates

The bottom of the tab shows your live rates — base currency, converted currency, the rate, which provider fetched it, when, and whether it's fresh (green OK) or stale. Hit Refresh Now to pull new rates immediately.

Checkout

Controls what your customers see during checkout when they're viewing prices in a different currency.

Checkout Disclosure

This is the notice that tells customers: "Hey, you're looking at prices in EUR, but you'll actually be charged in USD." It's important — keeps things transparent, avoids chargebacks from confused customers.

• Enabled — on by default, and you should probably leave it that way
• Disclosure Text — customise the message. You can use these placeholders:

The default text is: "Your payment will be processed in {base_currency}."

If you leave it blank, a generic fallback kicks in: "Prices shown in EUR are approximate. You will be charged in USD." — always clear, always honest.

The notice shows up in three places automatically: below the checkout summary, inside the cart drawer, and on the cart page.

Rate Freshness Badge

Adds a small "Rates updated 2 hours ago" line with a green dot in the currency switcher dropdown. If rates are stale, the dot turns red. Gives visitors confidence that the prices they're seeing are current.

CRM

Connects Multi-Currency to FluentCRM and FluentCommunity. These settings only matter if you have those plugins installed — if you don't, this tab still shows up but nothing will fire.

FluentCRM Sync

When enabled, the plugin automatically tags your FluentCRM contacts based on their currency preference. A customer who browses in EUR gets a currency:EUR tag. Someone who pays in GBP gets tagged too. This lets you segment your email lists by currency — send promotions in the right currency, target specific regions, that kind of thing.

The field names are customisable in case they clash with fields you've already set up. Most people leave the defaults alone.

See FluentCRM Integration for the full breakdown of what syncs and when.

FluentCommunity Sync

One toggle. When enabled, the plugin saves each user's preferred currency to their FluentCommunity profile. That's it — simple, no configuration needed beyond flipping the switch.

See FluentCommunity Integration for details.

Diagnostics

Nothing to configure here — this is your health check dashboard. Useful when something isn't working and you need to figure out why (or when support asks "what does your diagnostics tab show?").

Four cards at a glance:

If something looks off — a red badge, a missing dependency, stale rates — this is where you'd spot it first.

Quick Setup Checklist

Just installed? Here's the fastest path to a working multi-currency store:

1. General tab → Make sure it's Enabled. Set your base currency.
2. Currencies tab → Add the currencies your customers use. Don't forget your base currency if you want it in the switcher.
3. Exchange Rates tab → Pick a provider (ECB is free and works great for major currencies). Hit Refresh Now.
4. Checkout tab → Leave disclosure enabled. Customise the text if you want.
5. Drop the shortcode → Add [fchub_currency_switcher] to your header, menu, or wherever makes sense. See Currency Switcher for details.

That's it. Five steps, five minutes, and your store now speaks multiple currencies.

All Settings Reference