Layers List panel

source:trunk/resources/images/dialogs/layerlist.svg Keyboard shortcut: Shift+Alt+L - one of the JOSM panels

The Layers panel lists all loaded layers, controls their visibility and allows to activate one layer for editing map content.

Layer types

Layers of one type can exist multiple times in a JOSM session, except the validator and the notes layer. Plugins (e.g. Mapillary) can add other layer types.

Layer Buttons

Each layer has some buttons or clickable areas in its row in the layer list:

Icon Description
source:trunk/resources/images/dialogs/layerlist/active.svg Activate this layer
source:trunk/resources/images/dialogs/layerlist/scale.svg Snap/unsnap the map zoom to the native resolution of this background imagery
source:trunk/resources/images/dialogs/layerlist/offset.svg Reset the imagery offset
source:trunk/resources/images/dialogs/layerlist/eye.svg Hide/unhide the layer

Panel Buttons

The Layers List has five buttons at its bottom which operate on the marked layers:

Move Up

source:trunk/resources/images/dialogs/up.svg Up moves the selected layers up one row in the layer stack.

This is important when items in one layer obscure those in layers below. You can reorder layers also by drag and drop.

Move Down

source:trunk/resources/images/dialogs/down.svg Down moves the marked layers down one row in the layer stack.

Activate Layer

source:trunk/resources/images/dialogs/activate.svg Activate activates the marked layer.

It is only possible to edit map data in an active Data layer. Each of the layers can be activated with an individual keyboard shortcut sequence: Shift+A followed by [1–0A-Z] - where 1 is the top layer; counting down to 9, then 0 which activates 10, then A-Z. Press Shift+A only and wait a second. JOSM will display a list with all layers and their shortcuts in this format.


source:trunk/resources/images/dialogs/layerlist/visibility.svg Once clicked on, it offers:

  • A checkbox to show/hide a layer, i.e. turns visibility of marked layers on or off. The layers are unchanged when hidden, but their contents are not shown. You can also use shortcuts to show/hide a layer, see keyboard shortcuts below.
  • A slider to adjust the source:trunk/resources/images/dialogs/layerlist/transparency.svg Opacity of marked layers.
  • A slider to adjust the source:trunk/resources/images/dialogs/layerlist/colorfulness.svg Colorfulness of marked layers.
  • A slider to adjust the source:trunk/resources/images/dialogs/layerlist/gamma.svg Gamma of marked layers.
  • A slider to adjust the source:trunk/resources/images/dialogs/layerlist/sharpness.svg Sharpness of marked layers. Colorfulness, Gamma and Sharpness are only available for imagery layers.

For gpx layers you can choose one of 7 default colors. (Other colors are available via Customize Color in the gpx layer context menu).

Note: For ease of use you can use mouse scrolling to move a slider while the pointer is placed at the slider – no need to click-drag-release the slider picker.

Keyboard Shortcuts

Following hotkeys are used to control visibility of layers counted from top or bottom:

  • Shift+S followed by [1–0A-Z] - where 1 is the top layer; counting down to 9, then 0 which toggles 10, then A-Z, S has a special meaning as it repeats the last toggled layer. Press Shift+S only and wait a second. JOSM will display a list with all layers and their shortcuts in this format.
  • Alt+[1–0] - where 1 is the bottom layer; counting up to 9 and then 0 which toggles layer 10. (Use only the numbers above the letters on your keyboard, not the numbers in the numeric keypad.) The layer numbers in this format are displayed by default in the layer list.

Delete Layer

source:trunk/resources/images/dialogs/delete.svg Delete permanently deletes the marked layers. All unsaved changes will be discarded!

If you try to delete an OSM data layer or Notes layer which contains changes, JOSM will open the Unsaved Changes dialog, asking to upload and/or save these changes.

Individual Buttons

There might be more buttons depending on the loaded plugins, e.g. source:osm/applications/editors/josm/plugins/rasterfilters/images/josm_filters_48.png RasterFilters plugin.

Back to Windows menu
Back to Sidebar
Back to Main menu
Back to Main Help

Last modified 4 months ago Last modified on 2023-12-30T18:31:40+01:00

Attachments (2)

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.