Adding a City to OpenStreetMap

So your city is missing from OpenStreetMap? These instructions almost certainly gloss over some of the details, but essentially this is the process:

  1. First, to add an admin_level boundary, the boundary has to be “administrative”. OSM gets pretty cranky about not putting in admin_level boundaries for things that aren’t administrative. The definition can be found here. Essentially, there has to be some form of government that recognizes the boundary for administrative purposes. That’s why, for example, Rhode Island counties are not admin boundaries in OSM but counties in other states are. MA counties are being debated and for the moment nobody’s gone hog wild and removed the admin_level tagging. But that’s probably deeper into OSM ivory tower geography politics than you really want to go.

  2. Even if a boundary is not administrative it can still be marked as some other type of boundary. For example, the RI counties are (IMO obnoxiously) marked as boundary=region. But there’s also boundary=census, boundary=postal_code, etc. A full list can be found here. I’m guessing that it doesn’t actually matter that the boundary is marked as administrative as long as it’s in OSM as a properly-formed polygon. For example, Hawaii doesn’t have cities and towns, so no admin boundaries below the county level, except for Honolulu which I’ve gotten away with so far. There’s a boundary for, say, Haleiwa, but it’s a census boundary and not an “admin” boundary.

  3. If the boundary is real and it really doesn’t exist in the map, you need to download and install the JOSM program to edit the map.

  4. Next, you have to find a data source for the boundary. Usually this is something like a state or county GIS web site that has shapefiles or KML files or something like that. There’s a plugin for JOSM that lets you read those files.

  5. Once you have those files, load them into JOSM, and copy the polygon for the boundary you need to add into a new layer. Add the polygon into a boundary relation and add all the proper tags to it. Ensure that inner/outer relation roles are set properly.

  6. Hit the “validate” button. That will ensure you didn’t make any errors. If that checks out ok, hit the upload button and voila! New boundary.

  7. If the boundary contains parts of existing boundaries, it gets a little more complicated. You want to reuse any existing boundary fragments from other boundaries so you don’t have a bunch of duplicate lines overlapping in the map. You’ll need to do a bunch of splitting and combining to do this properly. It does take some practice to get the hang of it.

I hope this helps. To be clear, adding in admin levels isn’t the generally the issue, it’s adding in the boundary polygons themselves. I would suggest boundary relations are probably not a good starting point for novice mappers, but it’s actually pretty straightforward once you get the hang of it.

OSM has a slack server and the folks on there are generally pretty helpful: OpenStreetMap Chat


Very informative. Thank you

Hi, this is great, thank you.
Are there any other requirements for what pulls through as a city on top of it having a boundary (also, is administrative needed, or can political and other similar types work?), as I have both done this myself for an area (Relation: ‪Queensbury Ward‬ (‪11875021‬) | OpenStreetMap), and am waiting for it to pull through, but have noticed there are other areas already set up with an administrative region ages ago (years) that don’t pull through as “cities” (e.g. Clayton: Relation: ‪Clayton‬ (‪7187818‬) | OpenStreetMap) .
Comparing it to a third that does appear on City Strides (Alwoodley - Relation: ‪Alwoodley‬ (‪4797099‬) | OpenStreetMap), there isn’t much different, but i don’t know what is necessary and what is optional).

Once the city is in OSM, you need to get it to import into CS. That’s a different thread: How to help with missing/broken cities/regions


Oh my, I’m terrible at computers. There is no way i can do this. Can somebody add Orange Connecticut for me please.


Looks like it’s already in OpenStreetMap. So, it’s up to CityStrides.

What’s open street map. Thank you in advance

Open Street Map is a web site that is the map of the world. Like Wikipedia, it’s editable by anyone.

It’s also the basis for almost all maps on the internet. Including this site.

1 Like

A post was split to a new topic: Can someone add Martinez, Georgia?

I added Castro valley to the list many months ago and wondering if or when it can be added?

I’m addicted.

I added Norfolk, VA and Portsmouth, VA to the tracker a while ago. They both appear in OSM, but I’m sure I’m missing something. Any idea when those two cities will be imported? Thanks for all of the awesome (and hard) work!

These were just added

…somehow I’ve added three Norfolks (update: fixed)

1 Like

A post was split to a new topic: Help adding a CDP to OpenStreetMap