Markets & Multi-Currency

What this does for you

Markets let you group the countries you sell into together, and attach a
currency to each group. Instead of managing pricing, tax, and reporting on a
country-by-country basis, you define a small number of Markets — for example
"North America" or "Europe" — assign the relevant countries and currency to
each, and then reference that Market when you set up proposals, invoices, and
subscriptions.

Every organization starts with a built-in Default market. Any country you
haven't explicitly placed into a Market automatically falls into Default, so
nothing is ever left unconfigured — it's just sitting in Default until you
move it.

Who can use it

Access is controlled by your organization's role permissions:

• Viewing the Markets page requires market.view.
• Creating a market requires market.create.
• Editing a market requires market.edit.
• Archiving or reactivating a market requires market.archive.

If you don't have the right permission, the page shows a "You don't have
access to this page" message, and action buttons are disabled with a tooltip
telling you which permission is missing — ask your organization admin for
access.

Where to find it

Go to Catalogue → Markets in the left navigation (/configure/market).

The list page shows:

• Summary cards — Total MRR, Largest market, Fastest growing, Currencies,
  Not launched. These populate once revenue data is flowing through a market.
• Tabs — All markets, Active, and Archived, each with a count.
• Filters for status and creation date, plus a search box for market name
  or currency.
• A table of every market, with search, sorting, and column
  customization available from the table toolbar.

How to use it

Creating a market

1. Click + New market. A panel titled New market opens on the
   right.
2. Fill in:
   • Market name (required) — must be unique within your organization.
   • Notes — optional context for your team.
   • Status — Active or Archived.
   • Country — one or more countries this market covers. A country can
     only belong to one market at a time; countries already assigned to
     another market show as unavailable with an "already in [market]" label.
     To move one, use Re-Map on the market that currently holds it.
   • Currency — the billing currency for this market.
3. Click Create.

The new market appears in the list immediately and becomes selectable
wherever markets are used — plans, pricing, and customer records.

If you start filling out the form and try to close it, you'll be asked to
confirm before your changes are discarded.

Editing a market

Open the row's actions and choose Edit (not offered for archived markets),
or open the market and click + Edit market on its detail page. Either path reopens the same panel,
titled Edit market, pre-filled with the market's current values. Update
what you need and click Update.

The Default market is the one exception — it has no Edit button, since
it exists purely to catch unmapped countries rather than to be configured
directly.

Viewing a market's details

Click a market's name to open its detail page (/configure/market/:id).
You'll see:

• Header — market name, status, and date of creation (DOC).
• Details panel — Market ID (a stable identifier used elsewhere in the
  system), currency, and the market's notes.
• Countries table — every country mapped to this market, with the date
  each one was added (DOA) and a Re-Map action per row.

For the Default market, this table shows whatever countries haven't been
claimed by another market yet. If every country has been mapped elsewhere,
it shows a note that unmapped countries will land here automatically,
instead of an empty table.

Re-mapping a country

Use this to move a single country from one market to another without
recreating anything.

1. On a market's detail page, find the country in the table and click
   Re-Map.
2. In the dialog — "Select a market to re-map '[country]' from
   '[current market]' to:" — choose the target market from the dropdown.
3. Click Re-Map country.

The country moves immediately: it disappears from the current market's
table and appears in the target market's table with a new date of addition.
Re-mapping does not affect any proposals, invoices, or subscriptions
already created while the country was in its old market.

To add countries that no other market holds, edit the market's Country
field directly. Re-Map is the way to move a country another market already
holds. Re-mapping a country to the Default market simply returns it to
unmapped.

Archiving and reactivating a market

Markets aren't deleted — they're archived instead, so historical data tied
to that market (invoices, subscriptions) stays intact.

From the list, use the row action Archive on a market to archive it, or
Unarchive on an archived market to bring it back. You'll be asked to
confirm — "Do you want to archive/activate this market — [market name]?"
— before the status change goes through.

The Default market can't be archived.

Exporting market data

Use the Export button at the top of the list:

• Current table data — only the columns currently visible, respecting
  any filters you've applied.
• Full data export — every field, regardless of what's shown on screen.

Tips / things to know

• A market's name must be unique within your organization.
• Re-mapping a country moves it immediately and doesn't retroactively affect
  records created under its old market.
• The Default market is where any unmapped country lands — check it
  periodically if you expect every active country to have an assigned
  currency.
• Multi-currency pricing (different prices per currency for a plan or
  product), FX conversion rates, and prepaid wallet currency changes are
  currently handled by our team on request — this is not yet a self-service
  option in the product interface. If you need a plan or product priced
  differently across currencies, or a customer's prepaid wallet moved to a
  new currency, contact support.