---
title: "Breaking: #437 - Refactor allowedCountries TypoScript Configuration"
manual: "Cart"
version: "12.1"
permalink: "https://docs.typo3.org/permalink/extcode/cart:breaking-437-allowedcountries@12.1"
source: "Changelog/9.0/Breaking-437-RefactorAllowedCountriesTypoScriptConfiguration.rst"
rendered: "2026-11-14T23:50:30+00:00"
---

# Breaking: #437 - Refactor allowedCountries TypoScript Configuration {#breaking-437-allowedcountries}

See `Issue 413 <https://github.com/extcode/cart/issues/413`

## Description {#description}

In order to streamline the TypoScript configuration the configuration
for allowedCountries was changed.

## Affected Installations {#affected-installations}

All installations using an own configuration for `plugin.tx_cart.setting.allowedCountries` or
override the `Resources/Private/Partials/Cart/OrderForm/Address/Billing.html` or
`Resources/Private/Partials/Cart/OrderForm/Address/Shipping.html` partial.

## Migration {#migration}

### TypoScript {#typoscript}

Adapt the new TypoScript configuration structure. Instead of:

```typoscript
plugin.tx_cart {
    settings {
        allowedCountries {
            de = Deutschland
            at = Österreich
            ch = Schweiz
        }
        defaultCountry = de
    }
}
```

use a structure like this:

```typoscript
plugin.tx_cart {
    settings {
        countries {
            preset = 1
            options {
                1 {
                    code = de
                    label = Deutschland
                }
                2 {
                    code = at
                    label = Österreich
                }
                3 {
                    code = ch
                    label = Schweiz
                }
            }
        }
    }
}
```

### Templates (Partials) {#templates-partials}

Use `settings.countries.options` instead of `settings.allowedCountries` in the partial,
and add both `optionLabelField="label"` and `optionValueField="code"` to the country
selectors.
