← Help

Walking a city together

A challenge lets a group of friends complete a city as a team. Everyone keeps walking as usual, and all of your streets add up to one shared map. Your own map, walks, and progress stay exactly as they were. Challenges work between Android and iPhone.

🔒
Only your team can read it. Everything a challenge shares is encrypted on your phone. The server stores it but can't read it, and neither can I. See what your team sees below.

Start a challenge

  1. 1 Open Settings › Challenges and tap Start a challenge.
  2. 2 Pick an area: a whole city, or one area of a city that is split into areas. It has to be downloaded on your phone.
  3. 3 Choose what counts (see below), name the challenge, and pick the name your team will see for you. A nickname is fine.
  4. 4 Share the invite link or QR code with the people you want in the team.

Join a challenge

Tap the invite link on your phone. If CityWalker is installed, it opens the invite. If not, the link opens a page on citywalker.app that shows how to install it; tap the link again once the app is installed. You can also paste a link: open Settings › Challenges and tap Join with a link.

Pick the name your team will see, and download the challenge's city if you don't have it yet. Streets you walked there before joining count too, unless the challenge's rules leave them out.

What counts

The person who starts a challenge decides this, and it can't be changed later:

Streets you marked as walked by hand count, but the team can see that they were marked: they show dashed on the team map, and the challenge shows how much of each walker's streets, and of the team's, were marked by hand.

Reading the challenge screen

ℹ️
Each phone works out the numbers from its own copy of the city's map. If yours is older or newer than the leader's, the challenge says so and offers to update it, since the percentages can be slightly off until it matches.

Invites, leaving, and deleting

What your team sees

The privacy policy lists exactly what the server can and can't see.

Something not working?

Questions

Is it free?

Yes. Starting, joining and walking a challenge costs nothing.

Do we have to walk together?

No. Everyone walks whenever and wherever they like in the challenge area, and their streets add up on the team map. If you do walk together, one phone recording the walk is enough.

Is it a competition?

It's a team goal: the number that matters is the team's percentage. The challenge also shows how much each walker claimed, so you can see who found which streets, but there's no leaderboard.

Can my teammates see where I live or where I walk?

No. They see which streets in the challenge area you've walked and the day you first walked each one. Never your routes, your GPS tracks, the time of a walk, or anything outside the area. What your team sees has the details.

Can the leader remove someone?

Not yet; it's coming in an update. For now, a walker leaves with Leave challenge on their own phone, and the leader can delete the challenge and start a new one.

Does it work in any city?

Any city you've downloaded in full, and any city split into areas, either the whole city or one of its areas. A city you added with Just a small area can't host a challenge; it shows as “not available” until you download all of it.

What happens when the team reaches 100%?

The challenge stays as it is, with the full team map and 100% for everyone to look back on. Challenges have no end date. When you're done, the leader can delete it, which also lets them start a new one.