---
title: "Breaking: #380 - TypoScript for countries in uniform format"
manual: "Cart"
version: "12.1"
permalink: "https://docs.typo3.org/permalink/extcode/cart:breaking-380-typoscript-for-countries-in-uniform-format@12.1"
source: "Changelog/9.0/Breaking-380-TypoScriptCountriesUniformFormat.rst"
rendered: "2026-11-14T23:50:30+00:00"
---

# Breaking: #380 - TypoScript for countries in uniform format {#breaking-380-typoscript-for-countries-in-uniform-format}

See `Issue 380` and [forge#435](https://forge.typo3.org/issues/435) and [forge#435](https://forge.typo3.org/issues/435)\_\_

## Description {#description}

Up to now it was possible to set the country specific configuration of shippings
and payments directly under `plugin.tx_cart.shippings` and
`plugin.tx_cart.payments`. Until the implementation of [forge#435](https://forge.typo3.org/issues/435)
that's how it was done in the extension itself although the documentation
already showed the new structure.

This breaking change does no longer allow the old structure. As a result the
structure to set options is uniform in different places which makes it easier
for Integrators to set up this extension.

The uniform structure are now given for options in:

-   `plugin.tx_cart.shippings` \- see below
-   `plugin.tx_cart.payment` \- see below
-   `plugin.tx_cart.settings.countries` \- see [Breaking 437 (Allowed Countries)](https://docs.typo3.org/permalink/extcode/cart:breaking-437-allowedcountries@12.1)
-   `plugin.tx_cart.settings.currencies` \- see [Breaking 437 (Currency)](https://docs.typo3.org/permalink/extcode/cart:breaking-437-currency@12.1)

## Affected Installations {#affected-installations}

All installations which use the old structure ()which is shown below in the
migration description) are affected. The TypoScript needs to be adapted as shown
below.

## Migration {#migration}

The country configuration needs to be wrapper in a `countries`
level.

The following two snippets show the BEFORE and AFTER implementation.

**BEFORE (in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript)**

```typoscript
plugin.tx_cart {
   shippings {
      de {
         preset = 1
         options {
            1 {
               title = Standard
               extra = 0.00
               taxClassId = 1
               status = open
            }
         }
      }
   }
   payments {
      de {
         preset = 1
         options {
            1 {
               title = Pay in advance
               extra = 0.00
               taxClassId = 1
               status = open
            }
         }
      }
   }
}
```

**AFTER  (in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript)**

```typoscript
plugin.tx_cart {
   shippings {
      countries {
         de {
             preset = 1
             options {
                 1 {
                     title = Standard
                     extra = 0.00
                     taxClassId = 1
                     status = open
                 }
              }
           }
        }
     }
   }
   payments {
       countries {
          de {
             preset = 1
             options {
                1 {
                   title = Pay in advance
                   extra = 0.00
                   taxClassId = 1
                   status = open
                }
             }
          }
       }
   }
}
```
