The Import Locations option in WPResidence helps you add location terms in bulk by using a CSV file. This is useful when you want to prepare your location structure in advance instead of creating cities, areas, and states one by one from the dashboard.
You can find this option in:
WPResidence Site Settings > Import Locations
What the Import Locations option does
This feature imports location taxonomy terms based on a CSV file.
The import works with these location levels:
State, City, Area
This means you can create a structured location hierarchy that the theme can later use in property search forms, filters, property submission forms, and listing pages.
CSV file requirements
To use the import correctly, the CSV file must include this exact header:
State, City, Area
The order matters, so the file should follow exactly the same structure shown in the theme settings.
Each row in the CSV should represent one location combination.
Example:
| State | City | Area |
|---|---|---|
| California | Los Angeles | Beverly Hills |
| California | Los Angeles | Hollywood |
| Florida | Miami | Brickell |
If you do not already have a CSV file prepared, you can use the sample file included in the theme/plugin files:
wpresidence-core/samples/import-locations-sample.csv
How to import locations
Go to WPResidence Site Settings from your WordPress dashboard.
Open the Import Locations tab.
Click Choose CSV File and select your prepared CSV file.
After the file is selected, click Import.
The system will read the file and create the location terms from the CSV rows.
Important notes before importing
Make sure the CSV file uses the correct header:
State, City, Area
If the header is different, the import may not work as expected.
Make sure the values are clean and consistent. For example, if one row says New York and another says new york, WordPress may treat them as different values depending on the setup and existing terms.
It is also best to avoid duplicate rows in the CSV file.
What happens after import
Once the import is complete, the locations become available in the theme’s location taxonomy.
You can then use these imported locations in:
search forms
property filters
property submission fields
location-based listing pages
location selection when editing or adding properties
If locations do not appear as expected
If the import finishes but the locations do not appear correctly, check the following:
Make sure the CSV file uses the exact required header.
Confirm the CSV content is separated properly and saved as a valid CSV format.
Check that there are no empty rows or formatting issues in the file.
Review whether some locations already exist in the website taxonomy, as existing terms may affect how the final structure appears.
Recommended workflow
A good practice is to import your location structure before adding many properties. This helps keep your city, area, and state taxonomy organized from the start and makes search setup easier later.
If you plan to use the locations in search, import them first, then configure the search form fields to use the location taxonomy structure.