Viewing Geography Regions in VoxDash

The View Geography Regions feature in VoxDash allows data providers to manage regional details for their maps. Once a map has been added to VoxDash, you can easily view, edit, delete, and export or import all the geographic regions associated with it.

​

Viewing Geography Regions

1. Open the Data Provider Panel

From your VoxDash dashboard, go to the Data Provider section. This area allows you to manage all datasets, maps, and visual elements associated with your organization.

2. Navigate to the Maps Page

Click Maps in the sidebar. Here, you’ll find a complete list of all maps currently available in VoxDash for your organization.

3. Find Your Map

Locate the map you want to work with. You can use the search bar or filters to quickly find it if you manage multiple maps.

4. On the Maps page, locate your desired map and click the menu icon (⋮) on the right side of its row.
5. From the dropdown list, choose View Geography Regions.

​

Exporting Regions

The Export feature allows you to download a complete Excel (.xlsx) file of all the map’s regions. This is especially valuable for:

• Backing up your region configurations
• Reviewing region data offline
• Sharing configuration with other team members or systems

​

To Export Regions:

1. In the View Geography Regions modal, click Export.
2. VoxDash generates the file and downloads it to your device.

The exported Excel file includes standardized columns such as:

• Region Name
• Region Code or ID
• Existing Alternate Names
• Add Alternate Names
• ISO Codes

​

Understanding the Exported Region File

The exported Excel file contains geographic metadata used by VoxDash to identify and match regions. Below is an explanation of each column in the exported file.

​

GeoNameId

A unique internal identifier assigned to the geographic region. This value is used internally by geographic databases and mapping systems. Example:

• 6252001 = United States

​

Region Name

The readable name of the geographic region. Examples:

• United States
• Ontario
• California
• São Paulo

This is typically the main column users use when reviewing or matching data.

​

ISO 3166-1 alpha-2

A two-letter country code defined by the ISO 3166-1 standard. Examples: This is one of the most commonly used geographic formats in ecommerce and analytics systems.

​

ISO 3166-1 alpha-3

A three-letter country code defined by the ISO 3166-1 standard. Examples: This format is often used in enterprise systems, APIs, and reporting platforms.

​

ISO 3166-1 numeric

A numeric country code assigned by ISO. Examples: Numeric ISO values are useful for systems that require numeric identifiers instead of text codes.

​

ISO 3166-2

A subdivision code used for states, provinces, districts, and territories. Examples: This field is especially important when working with regional analytics inside a country.

​

UN M.49

A geographic classification code maintained by the United Nations. These codes are used for international statistics and reporting. Examples include:

• 840 = United States
• 124 = Canada

This field may be useful for international reporting and statistical analysis.

​

GeoNames ID

A unique identifier from the GeoNames geographic database. GeoNames IDs are commonly used in GIS systems and geographic APIs. This field can help integrate VoxDash geographic data with external geographic platforms.

​

Source Provider

Indicates the provider or database source used for the geographic information. This helps identify where the geographic data originated.

​

Source Code

The original region code provided by the source database. This value may differ from ISO codes depending on the geographic data provider.

​

Admission Category

Defines the administrative classification of the region. Examples may include:

• Country
• State
• Province
• Territory
• District

This field helps distinguish between different geographic hierarchy levels.

​

Feature Code

A classification code that identifies the type of geographic feature. Examples:

• Country
• Administrative region
• City
• Island

This field is mainly used for geographic processing and internal mapping logic.

​

Latitude

The geographic latitude coordinate of the region. Latitude is used to position the region on maps. Example:

• 40.7128

​

Longitude

The geographic longitude coordinate of the region. Longitude works together with latitude for map positioning. Example:

• -74.0060

​

Population

The estimated population of the region. This field can be useful for demographic analysis and market segmentation.

​

Timezone

The primary timezone associated with the region. Examples:

• America/New_York
• Europe/Berlin
• Asia/Tokyo

This information may help when analyzing time-based data.

​

Parent Source Code

The identifier of the parent geographic region. Examples:

• A state may reference its parent country.
• A district may reference its parent province.

This field helps maintain geographic hierarchy relationships.

​

Existing Alternate Names

Contains alternative names already associated with the region. Examples:

• USA
• United States of America
• US

This helps VoxDash recognize multiple naming variations.

​

Add Alternate Names

A customizable field where users can add additional region aliases or alternate spellings. This is useful when your dataset uses non-standard region names. Examples:

• NYC for New York City
• Cali for California

Adding alternate names improves matching accuracy. Important Notes About Alternate Names Only the “Add Alternate Names” column is editable. When adding alternate names:

• Separate multiple values using the | (pipe) character.
• Alternate names are shared across every map that uses the same geographic region.
• Rows whose GeoName is not linked to a valid geographic region will be rejected with a row-level validation error.

Example: NYC | New York | New York City To learn more about ISO Codes read this document

​

updating Regions Alternative Names

Use the Import feature to upload or update region definitions in bulk.
This is particularly helpful when you need to:

• Add multiple new regions at once
• Update names or access levels for existing ones
• Align boundaries with changes in external geographic data

​

To Import Regions:

1. In the View Geography Regions modal, click Import.

2. Upload an Excel file (.xlsx) that follows the VoxDash region schema.
   • Each row should represent a single region.
   • Required columns include:
     • Region Name
     • Region Code or ID
     • Existing Alternate Names
3. Click Confirm to apply updates.

​

Best Practices

• Always export before bulk imports to retain a backup of your current configuration.
• Use consistent naming conventions for regions to ensure data joins correctly in analytics views.