This page is incomplete and heavily outdated. The "settings" and "offset bookmark" tabs are not explained. The screenshots are outdated. WMTS is missing. Changes from #16249 and #16301 are missing.

Preferences > Imagery

Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources, general imagery settings and offset bookmarks.

To display an imagery in the MapView use the main menu Imagery.

Imagery providers

This is the place to modify the list of imagery providers that is presented in the imagery menu and from which you can activate the imagery layers.

Activate more items in Imagery menu

1. Select one or more imagery provider of interest in the Available default entries table on the left
2. Optional: verify bounds on the map on the right
3. Click Activate (Activated default entries are highlighted green in both lists.)
4. Click OK to close the preferences dialog

Custom imagery URL

Add custom WMS imagery

1. Click just to the right of the Selected entries table on the bottom half of this tab

1. Insert Menu Name
2. Paste Service URL (Mac users: paste is ctrl-v in josm)
3. Click Get Layers
4. Select one or more layers
5. Click OK to close the window
6. Click OK to close the preferences dialog

Troubleshooting

If the WMS layer list cannot be loaded, a warning dialog is shown:

To trace the problem, copy the URL from most recent line from the console (e.g., GET http://vogis.cnv.at/mapserver/mapserv?...) and open it in your browser.

Add custom TMS imagery

1. Click just to the right of the Selected entries table on the bottom half of this tab
2. Click TMS!
3. Insert Menu Name
4. Paste TMS URL, replace x, y, zoom parameter in the URL by {x}, {y}, {zoom}, respectively. Use for instance {switch:a,b,c} or {switch:1,2,3,4} for a random selection of the subdomain. Example: http://{switch:a,b,c}.www.toolserver.org/tiles/bw-mapnik/{zoom}/{x}/{y}.png. See Maps#TileMapServicesTMS for more options.
5. Optional: insert the zoom range in Zoom
6. Click OK to close the preferences dialog

Delete entry from imagery list

1. Select one or more entries in the Selected entries table on the bottom half of this tab
2. Click to delete selected entries
3. Click OK to close the preferences dialog

Advanced: Add entry to list of predefined imagery

Read the Documentation and edit Maps.

Notes

Meaning of green and white rows

In upper table:

Green means item is also listed in lower table. (This is called "activated".)

In lower table:

Green means item is also listed in upper table.

In both tables if an item is white, it will only be found in one table, not both.

Neither green nor white lines have any relation to the state / health of the servers they mention, nor the validity of the URLs they contain.

Cache contents

You can use the "clear" button in each line to delete the cached images for each source. May need a JOSM restart to take effect in the view.

A possibly existing "Mapnik" line stems from using the slippy map shown by the JOSM download dialogue in a JOSM version before version 14495 (Dec. 2018). You can safely delete it.