Core Docs - Digital Publishing - Configure International Addresses

Rock Version: v20.0
Last Modified: 2026-05-01 1:28 PM

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.

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.

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.

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.