JOSM app icon

Browsers and internet

JOSM

JOSM is the desktop editor for OpenStreetMap on Windows, with offline editing, imagery backgrounds, tagging presets, validation and changeset upload.

WindowsGPL-2.0-or-later

Serious OpenStreetMap editing on the desktop

JOSM is the editor that experienced OpenStreetMap contributors use. It downloads map data for an area, lets you work on it offline with a keyboard and mouse, checks what you have drawn, and uploads the result as a changeset. Compared with the browser editor it is less friendly on first contact and far more capable once learned: large areas, imagery alignment, bulk editing, custom presets and a plugin ecosystem are all part of the normal workflow.

What the program does

You draw and modify nodes, ways and relations, and attach tags to them, either from a searchable preset list or by typing key and value directly. Background imagery from aerial and satellite providers can be loaded and aligned, and downloaded GPS traces can be shown underneath to check that geometry matches reality. A validator inspects the data for common mistakes, a conflict dialog handles overlapping edits, and everything you change is listed before upload so a changeset comment can describe it. Plugins add specialised tools for public transport, buildings, conflation, routing and much more.

The working rhythm

The usual sequence is to pan to your area, download the data, turn on whichever imagery is best locally, make the edits, run the validator and clear the warnings that matter, then upload with a short comment. Because the download is a snapshot, it is normal to work in small areas and upload often rather than to hold a large region for hours. Keyboard shortcuts carry most of the work once learned, and the tag panel stays open beside the map.

Settings and limits

JOSM is a Java application, so memory settings matter on large areas and the look of the interface depends on the running Java version; the project's Windows setup program is the simplest way in. Uploading needs an OpenStreetMap account, and the community expects edits to follow local conventions and the import guidelines. The learning curve is real: tag semantics, relation roles and the difference between a highway and a track are knowledge about OpenStreetMap rather than about the program.

Who should choose something else

Occasional contributors who fix two mistakes a year will finish faster in the browser editor, which explains its own interface and needs no installation. Mapping that is not OpenStreetMap belongs in a general geographic information system, and simply viewing recorded tracks is a job for a lightweight viewer. JOSM pays off for people who map regularly and want precision, bulk operations and imagery control.

Best for
Regular OpenStreetMap contributors who need offline editing, imagery alignment, validation and bulk tools on Windows.
Good to know
Uploading edits requires an OpenStreetMap account, and the program is a Java application, so memory settings and the installed Java version affect how it behaves.

How to get started

  1. Download the Windows setup program from the JOSM download page and install it.
  2. Pan the map to your area and download the OpenStreetMap data for it.
  3. Enable an aerial or satellite imagery layer and align it if the offset looks wrong.
  4. Draw or adjust nodes and ways, then apply tags from the presets menu.
  5. Run the validator, fix what matters, and upload the changes with a short changeset comment.

Questions & answers

Do I need an account to edit?

You can download data and edit offline without one, but uploading changes to OpenStreetMap requires a free OpenStreetMap account.

What is the difference from the browser editor?

JOSM offers imagery alignment, bulk operations, validation, custom presets and plugins, and it works offline. The browser editor is simpler and better for occasional small fixes.

Can JOSM use my own imagery?

Yes. WMS, TMS and WMTS sources can be added, and local files work too, which is useful when a survey produced its own orthophoto.

More in browsers and internet

View category