[[TranslatedPages]]
= Preferences > Imagery =

[[Image(source:trunk/images/preferences/imagery.png)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings, offset bookmarks and imagery cache settings.

To display an imagery ("background") in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.

[[PageOutline]]

== Imagery providers ==
Here you can modify the list of imageries which appear in the [wikitr:/Help/Menu/Imagery Imagery menu] as well as edit entries.

[[Image(predefined-imagery.png)]]

The top left list contains all available sources. If you select a source and if it is not provided global its bounds are displayed on the little map on the top right. You can filter this list by typing in the box above. You can use parts of the source name, the country code (e.g. cz), the country name (e.g. czech republic, use the country name in the language JOSM is set to), the source type (photo, historicphoto, map, historicmap, osmbasedmap or other) or the URL.

The bottom list contains all entries which will appear in the [wikitr:/Help/Menu/Imagery Imagery menu]. To copy an entry from the top list to the bottom list select it in the top list and click on the [[Image(source:trunk/images/preferences/activate-down.png,20,middle)]] **Activate** button. Activated default entries are highlighted green in both lists. (The green color doesn't say anything about the state/health of the servers they mention, nor the validity of the URLs.)

To update (reload from JOSM server) the list of default entries on the top click on the [[Image(source:trunk/images/dialogs/refresh.png,20,middle)]] button on the right.

To add an custom WMS/TMS/WMTS source click on the respective button on the right: [[Image(source:trunk/images/dialogs/add_wms.png,20,middle)]], [[Image(source:trunk/images/dialogs/add_tms.png,20,middle)]] or [[Image(source:trunk/images/dialogs/add_wmts.png,20,middle)]] and follow the instructions.

To delete an entry in the bottom list select it and click on the [[Image(source:trunk/images/dialogs/delete.svg,20,middle)]] button.

To add an entry to the top list of default entries read the [wiki:/Maps#Documentation Documentation] and edit [wiki:/Maps#Listofsources Maps] or its subpages (for advanced users).

== Settings ==
Here you can edit some general imagery settings.

== Offset bookmarks ==
Here are listed all offset bookmarks which can easily be added via "New offset" in the [wikitr:/Help/Menu/Imagery Imagery menu].

== Cache ==
Here are listed all cached images (tiles) from each source. You can use the "clear" button in each line to delete the cached images for each source. You may need a JOSM restart to take effect in the Mapview.

A possibly existing "Mapnik" entry [[ticket:17054|stems from]] using the slippy map shown by the JOSM [wikitr:/Help/Action/Download#Slippymap download dialog] in older JOSM versions. You can safely delete it.

[[Image(scr_imagery_prefs_cache.png,400px)]]

----
Back to [wikitr:/Help Main Help]