---
title: Countries and regions
slug: commerce-connect-15/docs/countries-and-regions
docTags: 
createdAt: 2026-07-30T20:34:43.000Z
---

Use countries and regions when configuring [markets](docId:_h9ohzitcrObk_HCvf6Hw) and tax jurisdictions, or on the front end when working with [orders](docId\:zn9Pkb7e1URJk6XhcLHYU). Installation creates an extensive list of countries.

Classes in this topic are in the following namespaces:

- `Mediachase.Commerce.Orders`
- `Mediachase.Commerce.Orders.Dto`
- `Mediachase.Commerce.Orders.Managers`

## Create countries and regions

The following example creates a country and an associated region:

```csharp
var dto = new CountryDto();
var countryRow = dto.Country.NewCountryRow();
countryRow.Name = "Country Name";
countryRow.Code = "AAA"; // Three-digit country code.
countryRow.Ordering = 0;
countryRow.Visible = true;
if (countryRow.RowState == DataRowState.Detached)
  dto.Country.Rows.Add(countryRow);
dto.EnforceConstraints = false;

var region = dto.StateProvince.NewStateProvinceRow();
region.Name = "My Region";
region.Ordering = 0;
region.Visible = true;
region.CountryId = dto.Country[0].CountryId;
if (region.RowState == DataRowState.Detached)
  dto.StateProvince.Rows.Add(region);
dto.EnforceConstraints = true;

CountryManager.SaveCountry(dto);
```

## Update countries and regions

The following example updates the ordering and visibility of a country and adjusts the ordering of one of its regions:

```csharp
var dto = CountryManager.GetCountry("USA", true);
var countryRow = dto.Country[0];
countryRow.Ordering = 20;
countryRow.Visible = false;

var ca = countryRow.GetStateProvinceRows().FirstOrDefault(x => x.Name.Equals("California"));
ca.Ordering = 5;

CountryManager.SaveCountry(dto);
```

## Delete countries and regions

The following example deletes a country:

```csharp
var dto = CountryManager.GetCountry("USA", true);
var countryRow = dto.Country[0];
countryRow.Delete();
CountryManager.SaveCountry(dto);
```