Skip to content

Regions

A region is a market you sell to — a country or group of countries that share the same money and the same rules. For example, you might have one region for Sweden (prices in Swedish kronor) and another for the rest of Europe (prices in euros).

Each region decides three important things for the customers in it:

  • which currency their prices are shown in,
  • how much shipping costs,
  • and how tax (VAT) is handled.

Getting these right matters, because they directly change the prices your customers see and pay.

How to open it

  1. Sign in to the admin system.
  2. In the left-hand menu, click Regions.
  3. You will see a table of your existing regions. The one marked default is the fallback used when a customer does not clearly belong to any other region.

What you can do here

Create a new region

  1. Click the New region button in the top-right corner.
  2. Fill in the Name — a friendly label like "Sweden" or "Europe".
  3. Fill in the Handle — a short, simple code with no spaces, such as se, eu, or us. This is used behind the scenes in web addresses.
  4. Set the Default locale — the language code for this market, such as sv for Swedish, en for English, or de for German.
  5. Set the Default currency — the money this region uses, written as a three-letter code such as SEK (Swedish kronor) or EUR (euros). See the note below on what this affects.
  6. List the Countries — the two-letter codes of the countries in this region, separated by commas, such as SE, DK, FI.
  7. Set the Shipping fee, the VAT rate, and the tick-boxes as described in the sections below.
  8. Click Create region.

To change a region later, click its name in the table, edit the fields, and click Save changes. To remove one, open it and click Delete region at the bottom.

Set the default currency (and how it affects pricing)

The Default currency is the money that customers in this region see and pay in.

  • A customer shopping in a SEK region sees prices in kronor.
  • A customer in a EUR region sees the same products priced in euros.

How prices get converted

You do not have to re-type every product's price for every region. The system converts prices into the region's currency for you, using an exchange rate. You just set the currency; the conversion follows.

Set the shipping fee

The Shipping box holds a single flat fee that is added to every order in this region.

  1. Type the amount in whole kronor — for example 99 means 99 SEK.
  2. Leave the box empty (or type 0) to offer free shipping.
  3. The fee is automatically converted into the region's own currency, the same way prices are.

Why is it typed in kronor even for a euro region?

Behind the scenes the shop keeps all its base amounts in Swedish kronor for consistency. You always type the shipping fee in kronor, and the system converts it to the customer's currency at checkout.

Set the VAT (tax) rate

VAT is the sales tax added to prices. Two settings control it:

  1. VAT rate — how much tax, written in a unit called basis points. A basis point is one hundredth of one percent, so:
  2. 2500 means 25%,
  3. 1200 means 12%,
  4. 600 means 6%. Leave it empty if this region has no VAT rate set.
  5. Prices VAT-inclusive (a tick-box) — tick this if the prices you enter for products already include the tax (the normal way for shops selling to the public). Untick it if your prices are shown before tax and VAT is added on top at checkout.

Choose the default region

Tick Default region to make this the fallback market. It is used when a customer's country does not match any other region. Only one region should be the default at a time.

Turn a region on or off

Tick or untick Active. An active region is open for business. An inactive one is hidden from customers but its settings are kept, so you can switch it back on later.

Every field explained

Field Plain-English meaning
Name A friendly label for the market, e.g. "Sweden".
Handle A short code with no spaces (e.g. se), used inside web addresses. Kept in lower-case.
Default locale The language for this market, as a short code (e.g. sv, en, de).
Default currency The money customers see and pay in, as a three-letter code (e.g. SEK, EUR). Prices are converted into it automatically.
Countries The two-letter codes of the countries in this region, separated by commas (e.g. SE, DK, FI).
Sort order A number that sets the position of this region in lists. Lower numbers appear first.
VAT rate (basis points) The tax rate in hundredths of a percent. 2500 = 25%. Empty means none set.
Shipping (SEK) The flat delivery fee added to each order, typed in whole kronor. Empty or 0 = free shipping. Converted to the region's currency.
Active Whether the region is open to customers. Off = hidden but saved.
Default region Marks this as the fallback used when no other region matches the customer's country.
Prices VAT-inclusive Tick if the product prices you enter already include tax. Untick if tax is added on top at checkout.

Common mistakes

Watch out for these

  • Confusing basis points with percent. The VAT box is not in percent. Type 2500 for 25%, not 25. Typing 25 would mean a tiny 0.25% tax.
  • Typing a currency symbol or amount in the currency box. The Default currency box wants a three-letter code like SEK or EUR, never a number or a kr/€ symbol.
  • Typing the shipping fee in the wrong unit. Type whole kronor — 99 for 99 SEK. Do not type öre or add decimals you do not mean.
  • Forgetting that shipping is always typed in kronor, even for a euro or dollar region. The system converts it for you.
  • Having more than one default region. Only one region should be the default. If you tick it on a new region, remember to untick it on the old one.
  • Getting country codes wrong. Use the standard two-letter codes (SE, DK, NO), separated by commas. Full country names will not work.

Still stuck?

If prices, shipping, or tax are not showing the way you expect for a market, email developers@kavelsoftware.se. Tell them the region's Name and what you expected to see versus what actually appeared.