After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

State Options

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

In many countries, the state, province, or region is a required part of a postal address. The information is used for shipping and billing information, to calculate tax rates, and so on. For countries where the state is not required, the field can be omitted entirely from the address, or included as an optional field.

Because standard address formats vary from one country to another, you can also edit the template that is used to format the address for invoices, packing slips, and shipping labels.

General configuration - state options State Options

Set up the state options

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. Under General in the left panel, choose General.

  3. Expand Expansion selector the State Options section and do the following:

    • In the State is required for list, select each country where Region/State is a required entry.

    • Set the Allow to Choose State if It is Optional for Country field to one of the following:

      Yes In countries where the state field is not required, includes the State field as an optional entry.
      No In countries where the state field is not required, omits the State field.
  4. When complete, click Save Config.