In this tutorial you will learn:
- How to transition from the old 3-digit ISO code Country Mask layer to the 2-digit ISO code Country Mask
To start this tutorial, you need:
- A MapBuilder web application. If you do have one, visit the tutorial Step 2: Create a MapBuilder application in ArcGIS Online
Transition to the new 2-digit ISO code Country Mask
A new Country Mask service is now live in MapBuilder! The previous version, the 2-digit ISO code Country Mask, will be discontinued from the MapBuilder template in August 2025.
If your MapBuilder application uses this country mask, then you will need to edit your configuration file parameters in ArcGIS Online. There are two options to perform this transition.
Option 1: Adjust your configuration file
1. Locate the correct property names and values in the configuration file
Your configuration file includes the property name and a corresponding value for all available WRI datasets and additional layers. The screenshot below highlights the property names and values for the Country Mask. It is located almost at the end of the file.
2. Adjust the country mask values
Set the property values to match these values. Please refer to the screenshot below:
"url": "https://services.arcgis.com/P3ePLMYs2RVChkJx/ArcGIS/rest/services/World_Countries_(Generalized)/FeatureServer"
3. Save the changes to your configuration file
If you edited your configuration file directly in the ArcGIS Online Configuration Parameters box, make sure to click the save button to apply the changes.
If you edited your code in either an online or desktop tool, copy and paste the new code back into the Configuration Parameters box in ArcGIS Online. Make sure to click the save button to apply the changes.
Option 2: Recreate your MapBuilder Application
Unfortunately, if you are unable to follow the steps in Option 1 and edit you configuration file, you will need to recreate your MapBuilder application. You can find the entry for the ISO code at the end of the second tab in our configuration form (see screenshot below).
If you need additional assistance, please do not hesitate to contact us.