Operations
Zip Assignments
Map view, assigning ZIP codes to workspaces, territory management
What This Does
ZIP assignments define which geographic territories each client workspace owns. When scraping runs, it pulls contacts from the ZIP codes assigned to that workspace for the target month.
How To Use It
Map View
- Go to Scraping → Zip Assignments tab (or use the map toggle)
- The map shows all assigned ZIPs color-coded by workspace (12 client colors)
- Zoom in to see individual ZIP code markers
- Click an assigned ZIP to see details (workspace, city, state)
Assigning ZIPs
Single assignment:
- Click an unassigned ZIP on the map
- This enters multi-select mode (ZIP turns green)
- Click more unassigned ZIPs to add them
- A selection bar appears at the bottom — click a client name to assign all selected ZIPs
Bulk upload:
- Click the Upload button in the toolbar
- Upload a CSV with columns:
zip_code,state,month - Select the target workspace
- Preview results with dry-run, then confirm
Managing Assignments
- Click an assigned ZIP → popup shows reassign option
- Use the table view (list icon) to see all assignments with delete option
- Bulk delete via the table view's multi-select
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
| Map shows all dark / wrong colors in light mode | Known bug — map tiles don't respect theme | Being fixed — currently uses CartoDB Dark Matter tiles always |
| ZIPs not showing on map | Need to zoom in past threshold | Zoom in — ZIP markers appear at zoom level 6+ |
| ZIP already assigned error | Another workspace owns that ZIP for the same month | Check the map — click the ZIP to see which workspace has it. Reassign or delete first |
| Bulk upload shows 0 imported | CSV format incorrect | Ensure columns are: zip_code, state, month (YYYY-MM format) |
Related Alerts
No specific alerts for ZIP assignments — it is configuration data, not pipeline execution.