Skip to main content

Using the new Control Panel? Dig into our new documentation

How to use map view and turf cut

Map view helps with planning in-person activities. Using the turf cutter in map view, you can quickly save people from a map to a list. Lists can be used to print walk sheets for door-to-door canvassing, as well as other actions. A person's primary address is used to place them on a map.

Table of Contents

Map features

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:

turf cutter off
turf cutter on

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. 

If you are having difficulty using the new turf cutter, you have the option of choosing to use the old turf cutter.


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.

auto turf - save cluster as a list

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)

people on a map

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.

  1. Click your mouse once to create the beginning point of the turf, which will display as a white box.
  2. Drag your cursor and continue clicking to create the boundaries of your turf - it can be any shape that makes sense for your needs.
  3. The points of people included in the turf will be highlighted in white.
  4. Double click to connect your last boundary to your starting point.
  5. Repeat steps 2-5 until your entire map is turf cut.
  6. If you begin cutting a turf and decide the shape is incorrect, press the escape key to cancel that turf.
  7. Turn the turf cut tool off by clicking the Turf Cut button - it will turn grey.
  8. Save your turfs as lists. To do so, click within the turf area and a pop-up will appear:

save new turf

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. 

Back to top

How to use lists and batch actions

How to print call and walk sheets

How to use the old turf cutter

What is primary address?

If you’re unclear on how this feature works, please ask a question. If you would like to see changes to this feature, please submit a suggestion.