> ## Documentation Index
> Fetch the complete documentation index at: https://help.broadstripes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How maps work

View and assess your project's contacts by location on a map.

## View all your people on a map

1. Start by clicking the **Maps** link on the navigation panel.\\
   <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/LeftNavPanel-Maps.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=86d8364f12e828e27f9206d5fc5ef005" alt="" width="255" height="358" data-path="images/maps/LeftNavPanel-Maps.png" />

2. Clicking this link takes you to Broadstripes' **Maps** page. By default, you'll see the location of every contact in your project pinpointed on the map that appears.

3. You can change the way contacts are marked by clicking the blue buttons in the left-hand panel: **markers, dots** or **heat**.

<Frame caption="Here, all contacts are shown with dots.">
  <img src="https://mintcdn.com/broadstripes/T4_xjLEXaC8BFbeQ/images/maps/ec5a8e5-MapsViewAllDots2.png?fit=max&auto=format&n=T4_xjLEXaC8BFbeQ&q=85&s=fd6ac69b698f939599b21ef9ad94afe5" alt="Here, all contacts are shown with dots." width="740" height="412" data-path="images/maps/ec5a8e5-MapsViewAllDots2.png" />
</Frame>

<Frame caption="Here are the same contacts shown as a heat map.">
  <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/7d60a75-MapsViewAllHeat2.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=24d24aa859bb0f8ae13a0dbb52afe227" alt="Here are the same contacts shown as a heat map." width="730" height="444" data-path="images/maps/7d60a75-MapsViewAllHeat2.png" />
</Frame>

4. You can hide all these contacts from appearing on the map by clicking again on the selected marker type (markers, dots, or heat) to **deselect** it.

<Frame caption="Click the selected marker type again to deselect it. When no marker type is selected, the contacts will be hidden (and won't appear on the map).">
  <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/0ca9c31-MapsDeselect2.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=4ade8d206dc47ec5797d4268e3a2decb" alt="Click the selected marker type again to deselect it. When no marker type is selected, the contacts will be hidden (won't appear on the map)." width="253" height="131" data-path="images/maps/0ca9c31-MapsDeselect2.png" />
</Frame>

5. For a better look, you can zoom in or out using the **zoom controls** on the left-hand side of the map, or with the **plus** and **minus keys** on your keyboard.

<img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/2b7dbc0-MapsViewZoom.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=06d7b5c4d60dbef78f63e0f15bd57021" alt="" width="201" height="157" data-path="images/maps/2b7dbc0-MapsViewZoom.png" />

## View your people with a search

Running a search from the maps page will find a specific group of contacts according to any criteria you choose — then display them on the map.

For this example, we'll use the map to decide where to start a card drive. We'll run a search to find where the highest density of unsigned cards is, and target that area first.

1. We'll start by running a recent search for everyone in our project who hasn't yet signed a card. (Learn more about creating custom searches like this in the [Search](/docs/search/search-builder-build-an-advanced-search/) articles).

<img src="https://mintcdn.com/broadstripes/T4_xjLEXaC8BFbeQ/images/maps/c1ef6e9-MapsSearch.png?fit=max&auto=format&n=T4_xjLEXaC8BFbeQ&q=85&s=93d9c9ce053112f1467a9d9850bc70c1" alt="" width="723" height="303" data-path="images/maps/c1ef6e9-MapsSearch.png" />

2. After running our "unsigned card" search, the map now shows an additional group of contacts, indicated by **purple dots**. By default, each search is given its own color, and the results are layered over what was already displayed on the map (unless you choose to hide a group of contacts, as explained above).

<img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/5b08a5d-MapsSearchcardno.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=c467c8f7c9d7c68ba6c2fdfebcd085ed" alt="" width="730" height="393" data-path="images/maps/5b08a5d-MapsSearchcardno.png" />

3. If we want to see just the contacts in the "unsigned card" search, we can hide the other contacts (explained above) or **remove** them from the map by clicking the icon.

<Frame caption="Click the minus icon to remove a group of contacts from appearing on the map.">
  <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/6e9b8bf-MapsCloseContacts.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=b3ea0af7307ebceb96d7ee655e46f212" alt="Click to remove a group of contacts from appearing on the map." width="253" height="120" data-path="images/maps/6e9b8bf-MapsCloseContacts.png" />
</Frame>

4. Once you are seeing only the contacts you need, clicking **markers** can be especially useful for seeing the highest number of contacts in an area at a glance.

<Frame caption="Contacts are shown with markers: Broadstripes automatically groups and displays a count of contacts in each section of the map.">
  <img src="https://mintcdn.com/broadstripes/T4_xjLEXaC8BFbeQ/images/maps/f288f44-MapsSearchcardnoMarkers.png?fit=max&auto=format&n=T4_xjLEXaC8BFbeQ&q=85&s=ef5cf892efab09295d4830e915c4261b" alt="Contacts are shown with markers: Broadstripes automatically groups and displays a count of contacts in each section of the map." width="687" height="412" data-path="images/maps/f288f44-MapsSearchcardnoMarkers.png" />
</Frame>

5. After deciding where to start my card drive, I can use Broadstripes' **driving directions** feature to help me get house-by-house directions for my visits. Read the [get driving directions for your list](/docs/getting-started/get-driving-directions-for-your-list/) article for more help.

## View people using shapes and shape groups

Another useful way to see a group of contacts by their location is using the **shapes** feature. A shape is an area of the map that collects groups of people inside saved, user-defined boundaries.

1. Start by clicking the **Shape Groups** drop-down menu in the upper left-hand corner of the map.

<img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/74d6d43-MapsViewShapeGroupDropdown.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=861bf80ae21cb44bfad5dcaff002c76b" alt="" width="282" height="206" data-path="images/maps/74d6d43-MapsViewShapeGroupDropdown.png" />

2\. Choose the shape group you want displayed on the map by **checking it**.

<Frame caption="Check the shape group(s) you want to view on the map.">
  <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/391c19c-MapsViewShapeWards.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=7625dd94f8109d06a9162029b832457e" alt="Check the shape group(s) you want to view on the map." width="509" height="391" data-path="images/maps/391c19c-MapsViewShapeWards.png" />
</Frame>

3. The map will instantly display all the shapes in the selected shape group.
4. Each shape is defined by an outline and a unique color. To get detailed information about the people located inside a shape, just hover over the map and click anywhere in the shape.

<Frame caption="Click a shape to see more details.">
  <img src="https://mintcdn.com/broadstripes/FjfaV-zpF0owhUI-/images/maps/8b90c87-MapsViewShape6Ward.png?fit=max&auto=format&n=FjfaV-zpF0owhUI-&q=85&s=e5761284663fee9c433cd6dcf7fd0bf6" alt="Click a shape to see more details." width="525" height="440" data-path="images/maps/8b90c87-MapsViewShape6Ward.png" />
</Frame>

5. You can learn more about shapes in the [working with shapes](/docs/maps/working-with-shapes/) article.
