---
title: "Regions"
description: "See the region records behind your store currencies, with their currency, payment providers and tax switches."
url: "https://docs.poltura.com/en/developer/regions/"
lang: en
alternates:
  en: "https://docs.poltura.com/en/developer/regions/"
  hu: "https://docs.poltura.com/hu/developer/regions/"
---

# Regions

See the region records behind your store currencies, with their currency, payment providers and tax switches.

- Where: Settings → Developer → Regions
- Status: Developer mode

This page appears only when [developer mode](https://docs.poltura.com/en/developer/) is switched on.

A region is the record that fixes the currency of a cart. Your store keeps one region per store currency. Each region is named after its currency, has no countries and has every payment method that can charge that currency. Where you ship is decided by the [countries in your markets](https://docs.poltura.com/en/settings/markets/#countries), not by regions. The store keeps these regions up to date itself. If you change their countries or payment providers here, the store puts them back the next time it updates them.

For everyday work, stay with [Markets](https://docs.poltura.com/en/settings/markets/) and [Payments](https://docs.poltura.com/en/settings/payments/).

![The Regions list with one region, HUF, its currency Hungarian Forint and its payment providers](https://docs.poltura.com/screenshots/en/developer/regions.webp)

## Before you start

You need a role that includes store settings, such as Owner, Administrator or Store manager.

## Create a region

1. Open **Settings** and choose **Regions** in the **Developer** group.
2. Select **Create**.
3. Type a **Name** and choose a **Currency**. Only the currencies of your store are offered.
4. Choose the **Payment providers** customers of this region can pay with. You may leave it empty for now.
5. Leave **Automatic taxes** ticked if tax should be calculated at checkout.
6. Tick **Tax inclusive pricing** if the prices in this region already contain tax.
7. Save. The page of the new region opens with no countries.

The region sells nowhere until you add a country to it. Creating a region here does not add a currency to the store and does not create tax rates: add the currency in [Store details](https://docs.poltura.com/en/settings/store/#currencies) first, and set the tax under [Taxes](https://docs.poltura.com/en/settings/taxes/#country).

## Add countries to a region

1. Open the region.
2. In the **Countries** section select **Add countries**.
3. Search if you need to, tick the countries and save.
4. The countries are listed on the region page.

A country belongs to one region at a time. A country that another region already covers cannot be added here: remove it there first.

## Remove a country from a region

> **Warning**
>
> The removal takes effect at once. Where shoppers can ship is decided by the countries in your markets, not by regions.

1. Open the region.
2. In the **Countries** section select the remove action on the country's row.
3. Tick **Yes, remove this country from the region**.
4. Select **Remove country**.

The country then belongs to no region and can be added to any other. You are not stopped from removing the last country: the region stays, empty, with its settings.

## Edit a region

1. Open the region and select **Edit region**, or select the pencil beside the value you want to change.
2. Change the name, the currency, the payment providers or the two tax switches.
3. Save.

Countries are not in this form. They are added and removed on the region page.

## Keep your own data on a region

Open the region and select **Edit custom data**. Each row is a key and a value that your integrations can read. Rows without a key are not saved. A value of `true` or `false` is stored as a yes or no value, a value made only of digits as a number, anything else as text.

## Delete a region

> **Warning**
>
> Deleting a region cannot be undone, and the admin does not check whether orders, prices or shipping still depend on it. Make sure nothing uses the region before you delete it.

1. Open the region.
2. In the **Delete this region** section select **Delete region**.
3. Type the name of the region to confirm.
4. Select **Delete region**. You return to the list.

## Good to know

- The list shows **Name**, **Currency**, **Countries** and **Payment providers**, 20 regions per page, ordered by name.
- A region with no payment provider cannot take payments. The region page says so in the **Payment providers** row.
- Two people editing the same region at the same time overwrite each other. The last save wins.
- The country picker of a new [location](https://docs.poltura.com/en/developer/locations-and-shipping/#locations) and of a new [tax region](https://docs.poltura.com/en/developer/tax-regions/) offers only countries that are in one of your regions.
- Most labels on these pages are in English, also when the admin language is Hungarian.

## If something goes wrong

- **"Another region in this store already covers one of those countries, so nothing was changed."** Remove the country from the other region first.
- **"That option is not one this store offers." on Currency.** The store does not support that currency yet. Add it in [Store details](https://docs.poltura.com/en/settings/store/#currencies).
- **"This field is required." on a Currency field you cannot open.** The currencies of the store could not be loaded. Reload the page and try again.
- **"Payment providers could not be loaded, so they cannot be changed right now."** Close the form without saving and try again later.
- **"That region could not be found".** It was deleted or belongs to another store.

## Related

- [Developer mode](https://docs.poltura.com/en/developer/)
- [Markets](https://docs.poltura.com/en/settings/markets/)
- [Payments](https://docs.poltura.com/en/settings/payments/)
- [Taxes](https://docs.poltura.com/en/settings/taxes/)
- [Tax regions](https://docs.poltura.com/en/developer/tax-regions/)
- [Locations and shipping](https://docs.poltura.com/en/developer/locations-and-shipping/)