Welcome to the JOSM online help system

This help portal can be corrected at
Some information might be outdated, because JOSM is constantly enhanced with more features and tools. Recently implemented features may miss good illustrations, animations, examples and text explanation. Please help improving by adding them or your personal tips and experience - this is a wiki!

Getting Started

Your first edits with JOSM

  • Introduction to JOSM - briefly covers downloading data, enabling and aligning imagery, main menu items, presets, validation, change-set comments and upload dialogue
  • Migration assist from iD, Potlatch2? or Vespucci? - only if you have difficulties or questions related to respective editor "I'm used to do (function) in (an editor) but what should I do in JOSM?"

OSM-wiki resources


OSM data model


Changesets exists for every of your "edit". They simply group data creations, modifications and deletions - with additional properties comment, created_by, imagery_used and several others (this information stored as simple tags). Similar to other wiki software, one changeset can affect one object (a single character edit in the text), but may contain big changes (removals of paragraphs, partial or complete rewrite of the text) with the only difference that geo information is edited instead of text. Investigating history of one character is equally hard to comparing text at given point in time. Since complete "text" in OSM is 30-600GB big therefore users speak of history within several changesets and not about complete history every time.

Upload changeset dialog - explains why you create a changeset and low level details about protocol that uploads data to the OSM server

JOSM concepts

Workflow examples

Recent changes

JOSM is in constant development and many features are implemented every year, you can miss some of its recently implemented features

JOSM tools (incomplete reference)

List below contains mosty/only unreplaceable tools with preference to core JOSM tools. "Incomplete" should be stated explicitly to avoid misunderstandings from any part.

Search among all JOSM tools and menu items - Ctrl+Spacebar

Basic shape of objects


Selection (or list of currently selected objects) is precisely described in Help/Dialog/SelectionList#Selection (because it is visible from this dialogue), it can be modified with following tools (incomplete list):


Tags of currently selected objects displayed in Tags/Memberships Dialog.

  • Copy - copy selected objects to the buffer
  • PasteTags - paste previously copied tags
  • Tabular editor (Ctrl+T) (from UtilsPlugin2)
  • (Shift+R) (from UtilsPlugin2) copy tags from previous selection
  • Standard Add value (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue

Topology tools and changes

Geometry tools

Precision in angles

  • Anglesnapping will ease drawing way segments in 30°, 45°, 60° and 90° degrees
  • Extrude tool will ease drawing of strictly perpendicular segments


  • Parallel, draw lines and curves parallel to each other, draw nested infrastructure quickly
  • Extude mode used on segments - will move them in parallel, preserving angles when it is needed


  • Rotate objects at user-defined angle (but exact angle is unknown)
  • ShapeTools plugin:
    • Rotate object at predefined angle
    • Rotate objects (match building with road)
    • Rotate objects (match building with road, don't rotate more than epsilon)

Viewport control

JOSM interface

JOSM interface overview

Interface terminology (make sure to study bolded items first): Note: Together, 3 and 4 may contain too many items to display at once, use mouse scroll wheel in this case.

1. Main menu

2. Main toolbar (heavily customizable)

3. JOSM modes

4. toggles used to control on/off state of Windows

5. Status bar

6. Slider and scaler

7. Windows (or dialogs)
Layer List
Relations List
• (others)

8. Main editing window

9. Details about current mode

JOSM starting screen

  1. In JOSM, Help/Downloading data step performed first. For example, use simple Download menu
  2. Additional and more complex tools may be activated with Expert mode (also, pay attention to the left side of the screen)

JOSM interface complete reference

JOSM interface - complete reference. Pay attention, that menu pages at this wiki are very deep, just couple of examples below:

JOSM interface customization

See Help/JOSM interface customization for details.

Last modified 2 weeks ago Last modified on 2016-11-24T06:44:38+01:00

Attachments (8)

Download all attachments as: .zip