Importing Locations

CSV File Format

Your CSV file should include a header row with column names. The importer matches columns by name, so the order doesn't matter.

Required Columns

• name - Location name (e.g., "Downtown Store")
• address_line1 - Street address

Optional Columns

• address_line2 - Suite, unit number
• city - City name
• state - State or province
• postal_code - ZIP or postal code
• country - Country name or code
• phone - Phone number
• email - Email address
• latitude - Latitude coordinate (if you have it)
• longitude - Longitude coordinate (if you have it)
• visible - true/false to control visibility

Example CSV

name,address_line1,city,state,postal_code,country,phone
Downtown Store,123 Main St,New York,NY,10001,US,555-123-4567
Uptown Location,456 Park Ave,New York,NY,10022,US,555-987-6543
Brooklyn Branch,789 Atlantic Ave,Brooklyn,NY,11217,US,555-456-7890

Importing Process

1. From the dashboard, click Import in the navigation
2. Click Choose File and select your CSV
3. Review the column mapping preview
4. Click Import to start the import
5. Wait for the import to complete

The app automatically geocodes addresses that don't have coordinates.

Handling Import Errors

If some rows fail to import:

• Check for missing required fields (name, address_line1)
• Verify addresses are valid and can be geocoded
• Look for special characters that might need encoding
• Ensure the CSV is saved with UTF-8 encoding

Failed rows are listed with error messages so you can fix and re-import them.

Updating Existing Locations

To update locations via import, include a column that matches existing locations:

• Use the same name to update by location name
• The importer will update matching locations instead of creating duplicates