📌 Note: Geocoding, mapping, and walksheets are available as add-ons. For more information on adding new features please see the add-ons page in your nation.
Table of Contents
Watch a video
Map basics
To view people in your nation on a map, go to the People section and click on the map button. When you view people on a map, everyone with an exact address in their profiles is shown. There are two ways people are displayed on the map: in clusters (groups) and as points (individuals). At the top of the map, you have several options for who you would like displayed.
Slider: the slider allows you to zoom from a global map to street-view.
Filter: the filter button allows you to filter in real-time. Clusters will reload dynamically. In point view, any turf cut will remain and the new results will display within the turfs you created.
📌 When viewing a list as a map, you do not have the option to filter people. In a list's map view, the address accuracy dropdown is below the map rather than above it.
Address accuracy: by default, people with exact addresses in their profiles will be displayed on the map. You can change the level of address accuracy required with this drop-down menu.
Turf cutting: when you view the map, turf cutting is turned off, which is indicated by the grey button. Click the button and it turns blue, indicating that you can now cut turf. When using the turf cutter, double-clicking the mouse will always try to close the turf you're creating. Pressing the escape key while drawing the borders of turf will erase it. While you can turn on turf cutting at any time, you will find it most useful in point view.
Cluster view
Blue clusters indicate large groups of people on a map. You can click on the number within a cluster to zoom in on that part of the world - the cluster will transform into smaller clusters.
If you click an area of the cluster other than the number, a pop-up window will appear, allowing you to save the cluster as a list. These auto-turfs can help you quickly coordinate in-person activities.
The count of people displayed in clusters is approximate. Once you save a list from a cluster, the number of people on the list may be slightly different than the number reported in map view. Manually cut turf counts are exact.
Point view
When it makes sense to display people individually rather than in clusters, point view will appear automatically. This happens when you zoom in on clusters of people; the clusters will turn into points. Based on the number of people in your nation and their locations, clusters may or may not appear on your map.
Each point represents a person in your nation.
Within the U.S. the points will have 3 colors:
Red point = Republican voter
Blue point = Democratic voter
Grey point = All other people (includes people with other party affiliations and people who have no party affiliation)
Households in the U.S. are indicated as follows:
Point is larger and includes the number of people in the household.
If everyone in the household is Republican, the point will be red.
If everyone in the household is Democratic, the point will be blue.
If the household contains multiple party affiliations, the point will be grey.
Outside of the U.S., all points will be grey and households are indicated by a larger, grey point that includes the number of people who reside at the address.
Turf cutter
Turf cutting is the process of defining customized boundaries on a map. Once you cut turf, you can select the people within the turf and save them to a list. This process makes canvassing and phone banking more manageable.
When you click the Turf Cut button, it will turn blue to indicate you are in turf cutting mode. If you are in cluster view, you can change the boundaries of the clusters. Click the Clear turfs button at the bottom of the map and the clusters will disappear. You can define your own turfs, but when you begin, you won't see points on the map.
The easiest way to turf cut is to zoom in until you see points. Then, click the Turf Cut button. When you hover over the map, your cursor will look like a cross.
Click your mouse once to create the beginning point of the turf, which will display as a white box.
Continue clicking to create the boundaries of your turf - it can be any shape that makes sense for your needs.
The points of people included in the turf will be highlighted in white.
Double click to connect your last boundary to your starting point.
Repeat steps 2-5 until your entire map is turf cut.
If you begin cutting a turf and decide the shape is incorrect, press the escape key to cancel that turf.
Turn the turf cut tool off by clicking the Turf Cut button - it will turn grey.
Save your turfs as lists. To do so, click within the turf area and a pop-up will appear:
Here you can name the list, provide a slug, and share with other control panel users. Make sure to click Save list .
When you use the turf cutter to create your own turf, this pop up will also give you the option to delete the turf. If you click the Delete turf button, the turf area you created on the map will disappear and you'll be able to re-cut the turf. If you click the X at the top right of this pop-up, the turf will remain and a list will not be saved.
Turf created manually as described above will always have accurate counts of the number of people within the turf. You can filter after defining turf and the counts will reload, accurately reflecting the exact number of people who match your criteria and are located in the turf.
Related HOWTOs