Map & Location

How do I get directions to a contact?

Open the contact and tap their address. You'll be offered Apple Maps, Google Maps, or Waze depending on what's installed. You can also pin a contact's location without an address, which is useful for areas where street numbers don't exist.

How do I get directions to a contact?
My pin is in the wrong place. Can I move it?

Yes. Open the contact's address screen and drag the pin to the correct spot. You can also place a pin without an address at all, which is helpful in areas without precise geolocation data.

My pin is in the wrong place. Can I move it?
Why can't the map find my current location?

Check that location services are on and WitnessWork has location permission in your device's settings. Reopen the map and try again where your device can obtain a location. You can still enter an address or place a contact's pin manually without using your current location. If the problem continues, report the error with your device and operating-system version, leaving private contact details out of screenshots.

Why can't the map find my current location?
Why are some contacts missing from the map?

The map shows your active contacts that have an address or a pin, and it uses the same filters as your Contacts list. Last-visit chips, Saved Views, and filters from Sort & Filter all apply to both, so a contact hidden from the list is hidden from the map too. The chips at the top of the map show what's on; tap All, tap the selected Saved View again, or open Sort & Filter (the sliders at the top) and tap Reset to see everyone. If the chips are tucked away after you move the map, tap the Contacts title to bring them back. The map's own search only narrows the pins further and doesn't change the list. A contact you create by dropping a pin stays on the map until you switch to the list, even if your filters would hide it. Dismissed contacts don't appear; find them under ••• → Dismissed Contacts. A contact without an address or pin can't appear either; open the contact and add an address or place its pin. A contact with an address but no pin yet, such as one from an import, appears once its address is looked up: when the map has any, tap Find contacts on the map at the top to look them all up, or tap X to hide it. This sends those addresses to the WitnessWork server, which looks them up with HERE, a mapping service, and doesn't keep them. An address that can't be found isn't offered again until you edit it; place that contact's pin by hand instead. In data protection mode, addresses are never looked up, so place pins by hand. A contact saved without an internet connection appears once you're back online with WitnessWork open; if it still doesn't, edit its address or place its pin. This works the same on iOS and Android, and filters are worked out on your device; they aren't shared. If a contact is still missing, check its address, then contact support from the Help Center and leave out names and addresses.

Why are some contacts missing from the map?
What do the pins and cards on the map mean?

Each contact on the map is a round pin with their initials, colored by how long it's been since your last visit (tap the ⓘ button on the map to see what each color means, or change the colors in Settings → Preferences → Personalization → Color Key). A small mark on the pin's corner shows a follow-up that's overdue (red clock), a follow-up today (green clock), or a favorite (star).

Beside a pin, a card shows the contact's name and one detail. By default the detail is their next visit: an overdue follow-up, an upcoming follow-up with its day and time, or otherwise when you last visited. Cards for overdue and upcoming follow-ups are placed first, and cards that would cover another pin or card wait until you zoom in, so zoom in to see more. The selected contact's card turns green.

To choose what cards show, go to Settings → Preferences → Map, or tap the layers button on the map and choose Pin cards show. You can pick Next visit, Last visit, Follow-up topic, Name only, or any of your contact fields, such as a Language field when you work a language territory. A card shows only the name when that contact has no topic or no value in the field.

When pins sit on top of each other, they gather into one square pin with a count. Tap it: contacts at the same address, such as an apartment building, open in a list with their apartment or unit, most urgent first, and tapping a name selects that contact. Contacts that are only close together zoom the map in so their pins spread out.

The chip at the top of the map counts the contacts in view who are overdue or due in the next seven days. Tap it to keep only them bright, with their cards, and tap it again to see everyone. When today has a route, the Today's Route chip opens it. To plan a route from contacts on the map, see "How do I plan a route from the map?".

Pins and cards are worked out on your device and nothing is sent anywhere to draw them. The map doesn't rotate or tilt, so the cards stay next to their pins. This works the same on iPhone, iPad, and Android, and it's free. If a contact is missing from the map, see "Why are some contacts missing from the map?". If a card shows the wrong detail, check the contact's follow-up or field value; for other problems, use the Help Center's private support option and keep names and addresses out of public reports.

What do the pins and cards on the map mean?
How do I plan a route from the map?

On the Contacts map, tap the Select contacts button (the dotted lasso in the column of buttons on the left). Then tap pins to pick contacts, or draw a loop around pins with one finger to pick everyone inside it. Tap a square pin with a count to pick every contact in it. Tap Select Due to add everyone in view who is overdue or due in the next seven days. While you select, one finger draws instead of moving the map; pinch to zoom, or tap Done to move the map again.

Tap Plan Route to open today's route with the contacts you picked added after its stops, most urgent first. Contacts already on today's route, such as one with a follow-up today, aren't added twice. A route holds up to 10 stops, so Plan Route waits until your picks fit in the room today's route has left, which the bar shows when you pick too many; tap Clear to start over. From there, use Shortest Order, set how long you'll stay at each stop, and tap Start Route, as described in "How do I plan a route for my service day?".

Route planning is a Supporter feature. Anyone can select contacts and open the route to see the stops on the map; Shortest Order and Start Route need Supporter. When today already has a route, the Today's Route chip at the top of the map opens it.

Selecting contacts never changes them, their follow-ups, or your plans. The route is saved on this device for today and isn't synced to your other devices. This works the same on iPhone, iPad, and Android. If Plan Route stays dimmed, pick at least one contact and no more than the route has room for. If a contact you picked isn't on the route, the route was full: the route builder says how many didn't fit. For other problems, use the Help Center's private support option and keep names and addresses out of public reports.

How do I plan a route from the map?

Still need help?

Email for private support, or report a bug or request a feature on GitHub. Include what you tried, your device, and your WitnessWork version. Leave contact details, private notes, and account IDs out of public reports.

Reach out privately by email at support@leviwilkerson.com