From X-Cart 4 Classic
Revision as of 15:01, 30 July 2012 by Dohtur (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


For each of your store's 'active' countries that needs states, you must create a state list. State lists can be created and managed using the 'States Management' section of the Admin area (In X-Cart versions 4.4.0 and later, this section can be found at Shipping and Taxes menu -> States; in X-Cart versions 4.3.0-4.3.2, this section can be found at Settings menu -> States; in earlier versions, this section can be found at Management menu -> States).

During X-Cart installation, you can import pre-configured state lists for some countries (For information about importing states, see X-Cart:Installation page). If, during X-Cart installation, you imported states for your 'active' countries, you can view the respective state lists in the 'States Management' section: simply click on a country name link at the top of the 'States' dialog box, and the state list for the selected country will be displayed below:


By looking at a state list, you can find out the following information for each state:

  • CODE: The state code (must be unique on a per-country basis). State codes are used for X-Cart's inner processes and also appear in customer addresses on the invoice.
  • STATE: The state name.
  • COUNTIES: The number of counties in the state ('n/a' is displayed if no counties are defined).
COUNTIES column is displayed only when use of counties in the store is enabled. To enable use of counties, enable the option 'Use counties' in General settings->General options.

Important: We cannot guarantee that X-Cart's pre-configured state lists are complete or correct. For example, we haven't been able to find a standard list of counties for the United Kingdom, so the list of UK counties shipped with X-Cart provides a combination of lists from http://www.gbet.com/AtoZ_counties/ and http://www.ons.gov.uk/about-statistics/geography/products/geog-products-area/names-codes/eurostat/index.html with some corrections added by our clients residing in the UK. Before you use X-Cart's pre-configured state lists in your live store, please ensure they are adequate. You can edit any existing state list by adding, removing or editing the states contained in them as described below.

Adding states

To add a new state to the list:

  1. Go to the 'States Management' section.
  2. In the 'States' dialog box, scroll down to the 'Add new state' section.
  3. Provide the necessary information about the state being added: state code, state name and the country to which the state needs to be added.
  4. Click the Add state button. The state should be added. You should see an Information box with a confirmation message. To view the state you have added, click on the name link of the country to which you have added it - the state should be in the list.

Editing states

To rename a state or to change a state's code:

  1. Go to the 'States Management' section.
  2. In the 'States' dialog box, find the state name or code that needs to be edited.
  3. Change the code and/or the name of the state.
  4. Click the Update button to save the changes. The information should be updated. You should see an Information box with a confirmation message.

Deleting states

To delete one or more states:

  1. Go to the 'States Management' section.
  2. In the 'States' dialog box, find the states you wish to delete and select the DELETE check boxes opposite their names. You can use the Check all / Uncheck all links to select or unselect all the check boxes on the current page.
  3. Click the Delete selected button. The states selected for deletion should be removed. You should see an Information box with a confirmation message.

Multilanguage state names

Multilanguage state names are currently not implemented in X-Cart.