Home / GIS and Open Map Data for Beginners

OpenStreetMap Editor Guide: iD, JOSM, and Your First Safe Edit

Close-up of hands typing on a laptop keyboard

Photo: MART PRODUCTION / Pexels

Every OpenStreetMap contribution begins in an editor, and the project, being a commons, has grown several: a friendly one in the browser, a powerful one on the desktop, and a pocketful of phone apps. Beginners routinely stall at the choice, or worse, open the powerful one first and flee. This guide settles the choice in one table, then walks you through the editor almost everyone should start with, the iD editor that runs inside openstreetmap.org itself: what its screen shows, what its three drawing tools do, and a safe routine for a first edit that the community will welcome. It ends with the pre-upload review checklist that experienced mappers run mentally before every save, built into the tool on this page so you can run it literally.

If you have not yet read how a place gets added at all, our companion guide how to add a place to openstreetmap teaches the contribution itself; this article is about the instruments.

Interactive tool

OpenStreetMap Editor: Pre-Upload Review

Check off each step as you finish it. Your progress stays on this page.

0 of 7 complete

0% done

The Chooser Table

EditorRuns onBest forLearning curve
iDAny web browser, at openstreetmap.orgBeginners, quick fixes, adding placesGentle; has a built-in walkthrough
JOSMDesktop (Windows, Mac, Linux)Power users, large edits, imports, offline workSteep; rewards the climb
StreetCompleteAndroidMicro-edits while walking: answering simple questions about placesEasiest of all; no drawing
VespucciAndroidFull editing on a phoneModerate
Go Map!!iPhone and iPadFull editing on Apple devicesModerate

The pattern is honest: iD is the front door, JOSM is the workshop, and the phone apps are for editing where you stand. Ninety percent of new mappers should open iD, and most stay with it for years, because most real-world contributions are small: a cafe, a bench, a corrected name, a missing footpath. JOSM earns its learning curve only when your edits become bulk operations or intricate geometry.

A Tour of the iD Screen

Open openstreetmap.org, sign in, zoom into a neighborhood you know well, and click Edit. The iD editor loads with the map in the center and a satellite imagery layer beneath the data by default, so you see both the world and the map's current drawing of it at once.

The top bar holds the three drawing tools, explained below, plus undo and redo, the save button (which iD calls uploading your changeset), and your edit count. The left panel changes with context: click any existing feature and it becomes a form for that feature, name, category, and fields appropriate to its kind, which is how most editing actually happens, not by drawing but by completing forms. The right side carries the map controls: background imagery choices, map data toggles, and the issues panel, where iD politely flags problems in your edit, a road that crosses a building, a feature missing its category, before you upload. Read those flags; they are a patient tutor built into the tool. And before your first real edit, take iD's own walkthrough, offered on the help panel: ten minutes of guided practice on a training map where nothing you break matters.

The Three Drawing Tools

Point. Click once to place a single thing: a cafe, a bench, a postbox. Then fill its form. This tool performs the majority of beginner edits.

Line. Click along a path to draw an open line: a road, a footpath, a stream. Double-click to finish. The form then asks what kind of line it is, and the answer, residential road, footpath, cycleway, is the tag that makes your line a fact instead of a scribble.

Area. Click around a boundary and close the loop back on your first point to draw a filled shape: a building, a park, a lake. Buildings are the classic area edit, and iD helps by letting you square a building's corners with one keystroke after drawing, because the world is more rectangular than a mouse hand is steady.

Every tool shares one discipline: draw only what you can see in the imagery or know from standing there, and when the imagery and your knowledge disagree, trust your feet. Satellite pictures can be years old; the cafe that opened last month is your contribution to make.

A team meets around a table with laptops, sharing ideas
A team meets around a table with laptops, sharing ideas

The Safe-First-Edit Routine

  1. Choose a small, certain edit. A place you visit, whose name and category you know cold. Not a road realignment, not a boundary: a cafe.
  2. Zoom in far, until individual buildings are large. Most beginner geometry errors are zoom errors.
  3. Check it is really missing. Search the map and click nearby features; duplicates are the most common beginner mistake, and iD will warn you if your new point sits atop an existing feature.
  4. Draw and describe. Place the point on the building, near its entrance. Fill only the fields you are sure of: name exactly as the sign writes it, category, and leave the rest blank. A blank field is an honest field; a guessed field is a small lie told to millions of map users.
  5. Write a real changeset comment. One plain sentence: what you changed and where, like "Added Corner Cup cafe on Mill Street from local knowledge." Reviewers read these; future you will too.
  6. Upload, then look at your work on the main map after a few minutes, when the rendering catches up. Seeing your cafe appear on the world map is the hook this whole project runs on.

Two safety rails for every edit, first or five-thousandth. Never copy from Google Maps or other commercial maps; their licenses forbid it, and OSM takes the rule seriously enough to remove copied data. And when a warning from iD puzzles you, canceling costs nothing: an abandoned edit harms no one, while a confused upload creates work for the volunteers who will kindly repair it and write you a note you will wish you had not earned.

Growing Past Your First Edit

The path from first edit to trusted mapper is paved with small courtesies. Answer your messages: the community communicates through changeset comments and the site's inbox, and a reply, even "thank you, fixed," marks you as a collaborator rather than a drive-by. Stay local at first: your neighborhood is where your knowledge beats everyone's imagery, and a dozen careful edits there teach more than one ambitious edit across the country. Learn tags gradually: when you wonder how something is described, click an existing example of it in iD and read its form; the editor is its own best textbook, and our explainer of the data model in openstreetmap osm gives the theory behind the forms. Join the conversation when you are ready: local mapping groups and the community forum exist for every region, and the mapathon gatherings turn solitary editing into a social evening with pizza and a purpose. None of this is required. The map is grateful for a single honest cafe. But people who stay discover that mapping is less like data entry and more like gardening a commons: small tending, visibly compounding, in a place that belongs to everyone because people like them keep showing up.

Related Guides

If this page answered part of the question, these GIS and open map data guides cover the rest of the same ground:

Frequently Asked Questions

Which OpenStreetMap editor should a beginner use?

iD, the editor built into openstreetmap.org. It runs in the browser with nothing to install, includes a guided walkthrough, checks your work for common problems before upload, and handles the overwhelming majority of everyday edits. Graduate to JOSM only when you feel iD's limits personally, which for most mappers takes a long time or never happens.

Do I need an account to edit OpenStreetMap?

Yes, a free OpenStreetMap account, created in a minute with an email address. The account is how the community attributes edits, discusses them, and, when necessary, undoes them. Viewing the map needs no account; changing it does, which is the right way around.

What is a changeset?

The bundle of changes you upload in one save, together with its comment. Each changeset is public, numbered, and reviewable, which is the project's immune system: good edits stand, mistakes get spotted and reverted, and your changeset history becomes your reputation as a mapper. Small, well-described changesets are the mark of a trustworthy contributor.

Can I edit OpenStreetMap from my phone?

Yes. StreetComplete on Android turns editing into answering simple questions about places around you (does this shop still exist, what are its hours) and is the gentlest on-ramp of all. Vespucci (Android) and Go Map!! (iOS) offer full drawing tools for phone-first mappers. For careful geometry, though, a bigger screen in iD or JOSM remains easier.

What happens if I make a mistake in an edit?

Usually, very little, and it is fixable. You can edit again to correct it, or another mapper will, or a reviewer will revert the changeset entirely, restoring the previous state. The community assumes good faith from new accounts and reserves its firmness for copying from commercial maps and deliberate vandalism. Honest mistakes are tuition, and everyone mapping has paid some.

How long until my edit appears on the map?

The data updates instantly; the rendered map picture follows within minutes at most zoom levels, sometimes a little longer for the deepest zooms. Other apps built on OSM update on their own schedules, from daily to monthly, so your cafe may greet the openstreetmap.org map today and a hiking app next month.

What should I write in a changeset comment?

One plain sentence saying what changed and where: "Added two benches and a drinking fountain in Riverside Park, surveyed today." Reviewers and future mappers use these comments to understand intent, and a changeset with a real comment gets the benefit of every doubt. Vague comments like "fix" or "update" waste the project's cheapest quality tool, so the thirty seconds of writing is the best investment in the whole edit.

Photo credits: MART PRODUCTION (Pexels); fauxels (Pexels). Photos are served from this site; follow the credit to the library page for the original.