Configure International Addresses

By default, Rock is set to accept and display US-formatted addresses. For most organizations operating inside the US, this will be the preferred configuration. Enabling support for international addresses is simple and remarkably powerful. Let’s take a look.

Enabling International Addresses

The first step is to tell Rock that you would like to use international addresses when editing and viewing addresses.

  1. Navigate to Admin Tools > Settings > Global Attributes.
  2. Click the attribute Support International Addresses and choose Yes in the Support International Addresses field.

Rock will now display the inputs required for storing international addresses. It will also display addresses in an internationally-friendly way.

That was the simple part—now for the power!

Configuring International Addresses

Unfortunately, we live in a world with few standards. Why the world hasn't accepted the mile is beyond us (5,280 feet in a mile makes perfect sense. Brilliant really...) Perhaps nowhere is this more evident than with addresses. Some countries have 'states', others 'provinces'; some 'zips', others 'postal codes'. Some put the zip first; others put it last.

Rock allows for a good deal of configuration on how international addresses are entered and displayed. With a few exceptions, the configurations for each country will need to be adjusted as they change on a seemingly daily basis. To complete the configuration, follow these steps.

  1. Be sure that the countries you need are in the country list Admin Tools > Settings > Defined Types > Countries. Also ensure that the correct abbreviation is in the Value field and the proper terms for City, State and Postal Code are correct. Also adjust the Address Format as needed to fit the requirements of the country. This format is what will be used to display addresses inside of Rock for the given country.

2. Next, enter the Address States for the countries that will be commonly used. You’ll find these under Admin Tools > Settings > Defined Types > Address States. When entering new states, be sure to match them to the country using the country dropdown. When entering states, you'll enter the state abbreviation (e.g., 'AZ') in the Value field and the full name (e.g., 'Arizona') in the Description. Both values are required.  

Rock will now display the inputs required for storing international addresses. It will also display addresses in an internationally-friendly way.

Tip

Country Preference
When showing a list of countries, Rock will put the country of the organization both at the top of the list and also in alphabetical order. This allows the most commonly-selected country to be an easy selection for your users.