---
title: Canvassing
description: GPS-guided door-to-door canvassing with the volunteer map, visit recording, and walking routes.
icon: material/map-marker-path
tags:
  - guide
  - volunteer
  - map
  - canvassing
---

# Canvassing

The volunteer canvass map is your main tool for door-to-door outreach — a full-screen GPS-tracked experience.

![Full-screen volunteer canvass map with GPS marker and bottom toolbar](../../assets/images/screenshots/volunteer/canvass-map.png){ loading=lazy }

---

## The Volunteer Map

### What You See

- **Colored markers** — each marker is an address. Colors indicate the outcome of the last visit (green = supportive, red = opposed, grey = not yet visited)
- **Clusters** — when zoomed out, markers group together showing the address count. Tap a cluster to zoom in.
- **Blue dot** — your current GPS position
- **Walking route** — a suggested path through the addresses (dotted line)

### Recording a Visit

1. **Tap a marker** to select an address
2. A **bottom panel** slides up showing address details
3. Tap **Record Visit** to log what happened:
    - **Not Home** — nobody answered
    - **Supportive** — positive interaction
    - **Opposed** — not supportive
    - **Undecided** — hasn't made up their mind
    - **Moved** — no longer lives there
    - **Refused** — declined to talk
4. Optionally add a **note** about the visit
5. Tap **Save** — the marker color updates immediately

---

## Sessions

- **Start a session** before you begin knocking on doors — this tracks your route and time
- **End your session** when you're done for the day
- The map works offline for basic viewing, but you need a connection to save visits
- If GPS is inaccurate, manually tap the correct marker on the map

The map is designed to be used in the field on a phone:

![Volunteer canvass map on mobile](../../assets/images/screenshots/volunteer/canvass-map-mobile.png){ loading=lazy width=320 }

---

## Routes

The **Routes** tab shows your past canvassing routes on a map, helping you see which areas you've covered and plan your next outing.

![My Routes page with session stats and route map](../../assets/images/screenshots/volunteer/routes.png){ loading=lazy }

---

## Volunteer Routes

- `/volunteer` — full-screen canvass map with GPS and visit recording
- `/volunteer/activity` — visit history and outcome breakdown
- `/volunteer/routes` — past canvassing routes
