CSV Import Best Practices
How to format your file to ensure a smooth, error-free import
Uploading a clean CSV helps your contacts import faster and prevents skipped or missing records. Follow these guidelines before uploading your file.
✅ Required Fields
Each row must include the minimum information below.
If required fields are missing, the contact will be skipped during import.
| Field | Required |
|---|---|
| First Name | ✅ |
| Last Name | ✅ |
| Street Address | ✅ |
| City | ✅ |
| State | ✅ |
| Zip Code | ✅ |
| Phone or Email – ReEngage | ✅ At least one contact field (phone or email) is required. |
| Phone or Email – Outreach | ✅ Required only when enrich is NOT selected |
📌 Outreach Import Rules
| Scenario | Requirement |
|---|---|
| Outreach (Enrichment = Yes) | Only the property address fields are required (Street, City, State, Zip). |
| Outreach (Enrichment = No) | All Required Fields + one contact field (phone or email) is required. |
🧹 File Formatting Rules
| Rule | Why |
|---|---|
| Use the provided template | Ensures correct column order |
| Do not rename headers | System matches columns by name |
| Remove blank columns | Prevents import errors |
| Remove special characters (* / , etc.) | Prevents import errors |
| Remove formulas or styling | Only plain text should be included |
| Save as .CSV | Required file type |
✂️ Before Uploading Checklist
Quick 30-second review:
-
No empty rows
-
No merged cells
-
No bold or colored formatting
-
No extra tabs or sheets
-
Phone numbers formatted consistently
-
At least one contact method per row (when required)
🚫 Common Issues & Fixes
| Issue | Cause | Fix |
|---|---|---|
| Contacts skipped | Missing required fields | Update contact information |
| Import fails | Headers changed | Re-download template |
| Weird characters | Copied formatting | Paste as plain text |
| Extra columns appear | Hidden or blank columns | Delete unused columns |
| Partial imports | Blank rows | Remove empty lines |
| Customer pins not appearing on the map | Import not in the correct format | Bulk delete, format using the GlassHouse CSV template, and reimport |
💡 Pro Tips
-
Address Formatting Tip:
For the best results, keep address components in separate columns (Street, City, State, Zip). Combining them into a single field can prevent properties from appearing correctly on the map or being enriched properly.
Example of correct format:
| Street Address | City | State | Zip |
|---|---|---|---|
| 123 Main St | Augusta | GA | 30907 |
❌ Avoid combining the full address into one field like:
123 Main St Augusta GA 30907
-
Template Formatting Tip:
If you're unsure your file is formatted correctly, download the GlassHouse CSV Template and paste your data into it before uploading.
Need Help?
Contact success@glasshouse.biz with your CSV and we’ll provide guidance to help you complete your import successfully.