What You'll Learn in This Guide
1. Uploading Your File to Neural Earth
💡Pro Tips:
Download and use the Neural Earth Standard Address Upload Template to avoid formatting errors.
Before uploading, verify your addresses using the US Postal Service Address Verification Tool.
To batch upload properties to Neural Earth, follow the steps below to ensure a successful upload:
Navigate to the All Properties Page: Click on the All Properties icon in the left-hand menu and you will be directed to the All Properties page.
Start a New Batch Upload: To the right of the search bar, click the 'Batch Uploads' button to begin the upload process.
Download the Template: On the upload screen, click 'Download Template' to obtain the standard CSV format.
Prepare Your File: Fill out the template with your property details. Be sure to follow all address formatting guidelines to avoid errors.
Select the Target Portfolio: Click the select a portfolio dropdown button to choose which portfolio your properties should be uploaded to. This list displays all portfolios associated with your organization.
Need to create a new portfolio? Learn how to create a portfolio.
Upload Your File: Drag and drop your completed CSV file into the upload area.
File must be in CSV format. (CSV UTF-8 is recommended)
You can upload up to 1,000 properties per file. (Including header row)
File size must be under 5MB.
You must stay on the page during upload — navigating away will stop the process.
Once the file is accepted, you’ll see a green “Success! Batch upload in progress” notification and be redirected to the Batch Uploads page:
Upload status will appear in the table (e.g., In Progress, Completed, or Failed).
Once complete, download a receipt of the batch upload by clicking 'Download Log' in the table row.
2. How to Cancel a Batch Upload
You can cancel your own batch upload (but not someone else's) by:
Click 'Cancel Upload', located on the row in the batch upload table.
Confirming your decision in the pop-up screen by clicking 'Cancel Batch Upload'.
Once canceled, the upload status will display as Failed and you will receive a confirmation notification.
3. Error Handling and Troubleshooting
If your file contains formatting issues or missing fields, you’ll receive immediate feedback on the page.
Common upload errors include:
File size over 5MB.
Uploading over 1,000 properties per file.
Incorrect file format. (non-CSV or CSV UTF-8)
Missing required columns.
Columns are not named as expected.
Invalid or improperly formatted addresses.
If your upload fails:
You’ll see an error message with options to try again or re-upload after fixing the issue.
Neural Earth will return a CSV file that includes an “Issue Description” column.
Each row will list any detected errors inline, helping you quickly locate and correct formatting problems.
Still having issues? Contact support or review our batch upload guidelines.
4. Required Address Components
When uploading property addresses, ensure you include the following key fields in your file:
Field | Description | Example |
Unique Property Name | Each property must have a unique identifier within your portfolio. No duplicates allowed. | "Main St HQ" |
Street Address | Must include a street number, street name, and be located in the United States. Use standard abbreviations (see below). | "123 Main St" |
Unit/Apt | Specify the unit number or letter if applicable. Leave blank if not applicable. | "Apt 4B" |
City | Provide the full name of the city or town. Avoid abbreviations. | "Los Angeles" |
State | Use the official two-letter abbreviation for the state. See full state abbreviations list here. | "CA" |
ZIP Code | Include the full and accurate 5-digit ZIP code. | "90001" |
5. Standard Address Abbreviations
Ensure that all street names, compass points, and building designators follow standard abbreviations:
Street Names:
Avenue → Ave
Boulevard → Blvd
Center → Ctr
Circle → Cir
Court → Ct
Drive → Dr
Expressway → Expy
Highway → Hwy
Lane → Ln
Road → Rd
Compass Points:
North → N
East → E
South → S
West → W
Northeast → NE
Northwest → NW
Southeast → SE
Southwest → SW
Building and Apartment Designators:
Apartment → Apt
Building → Bldg
Floor → Fl
Room → Rm
Suite → Ste
6. Important Address Formatting Guidelines
Use Abbreviations Correctly: Always abbreviate address components as per the standards provided above.
Separate Each Building: For multi-building properties, list each building address separately in its own row.
No Special Characters: Avoid using symbols like "&" or "-", "#," or "Lot/Block" descriptors in non-standard formats.
Provide Up-to-Date Addresses: Use only the most current and official property address.
7. Common Address Entry Mistakes to Avoid
Incorrect address formatting can lead to processing failures and inaccurate reporting. If your upload fails due to these issues, Neural Earth will return a CSV file that includes an “Issue Description” column. Each row will list any detected errors inline, helping you quickly locate and correct formatting problems.
It is important to avoid including outdated or alias addresses to prevent processing issues. Here are some other common mistakes and how to avoid them:
Key Issue | Example of Incorrect Entry | Correction |
Incomplete Addresses | "123 Main St, Los Angeles" (Missing ZIP, State) | "123 Main St, Los Angeles, CA, 90001" |
Multiple Addresses Combined | "400 State St & 389-395 Main St, Hackensack, NJ" | Enter each address in separate rows. |
Special Formatting | "Bldg 5, Suite 200, 123 5th Ave, Mia. FL" | "123 5th Ave, Ste 200, Miami, FL" |
Alias or Alternative Names | "15 West Main Street - 2, Mendham, NJ" | Use standard USPS format only. |
Legal Descriptions | "Block 2, Lots 36.01 & 36.02, 455 Route 23, Wantage, NJ" | Provide only recognized street addresses. |
Ambiguous Locations | "Garrett Mountain Plaza, West Paterson, NJ" | Include a street number and full address. |
8. Example Address Upload Template
Here is an example of the correct address format you should use for batch uploads:
Unique Property Name | Street Address | Unit/Apt # | Building # | City | State | ZIP Code |
HQ Building | 123 Main St |
|
| Los Angeles | CA | 90001 |
Warehouse A | 400 Industrial Ave | Unit 5 | 1 | Chicago | IL | 60601 |
Apartment Complex B | 500 Elm St | Apt 3A | A | Dallas | TX | 75201 |
💡Pro Tip: Download the Address Upload Template
Download and use the Neural Earth Standard Address Upload Template to avoid formatting errors.
9. How to Ensure Accurate Address Uploads
To avoid processing issues and delays, follow these best practices:
Provide Complete and Verified Addresses: Ensure all fields (including ZIP codes and state abbreviations) are included and accurate.
Use Address Verification Tools: Before uploading, validate addresses with the US Postal Service Address Verification Tool.
Format Your Data Correctly: Ensure consistent capitalization and remove unnecessary spaces or characters.
FAQs
What happens if I upload an address incorrectly?
Incorrect addresses may result in failed uploads or inaccurate reporting.
Can I upload international addresses?
No, Neural Earth only supports addresses within the U.S.
What happens if I leave the upload page before completion?
The upload process will stop, and your file will not be processed. You’ll need to restart the upload.