MapComplete has a few data layers available in the theme which have special properties through builtin-hooks. Furthermore, there are some normal layers (which are built from normal Theme-config files) but are so general that they get a mention here.
Highlights the currently selected element. Override this layer to have different colors
- This layer is shown at zoomlevel **0** and higher
- **This layer is included automatically in every theme. This layer might contain no points**
- Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
- Not visible in the layer selection by default. If you want to make this layer toggable, override `name`
Meta layer showing the current location of the user. Add this to your theme and override the icon to change the appearance of the current location. The object will always have `id=gps` and will have _all_ the properties included in the [`Coordinates`-object](https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates) (except latitude and longitude) returned by the browser, such as `speed`, `altitude`, `heading`, ....
- Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
- Not visible in the layer selection by default. If you want to make this layer toggable, override `name`
Meta layer which contains the previous locations of the user as single points. This is mainly for technical reasons, e.g. to keep match the distance to the modified object
- Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
- This layer is not visible by default and the visibility cannot be toggled, effectively resulting in a fully hidden layer. This can be useful, e.g. to calculate some metatags. If you want to render this layer (e.g. for debugging), enable it by setting the URL-parameter layer-<id>=true
Meta layer showing the home location of the user. The home location can be set in the [profile settings](https://www.openstreetmap.org/profile/edit) of OpenStreetMap.
- Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
Meta layer showing the previous locations of the user as single line with controls, e.g. to erase, upload or download this track. Add this to your theme and override the maprendering to change the appearance of the travelled track.
- Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
- This layer is not visible by default and the visibility cannot be toggled, effectively resulting in a fully hidden layer. This can be useful, e.g. to calculate some metatags. If you want to render this layer (e.g. for debugging), enable it by setting the URL-parameter layer-<id>=true
This layer defines how to render the 'last click'-location. By default, it will show a marker with the possibility to add a new point (if there are some presets) and/or to add a new note (if the 'note' layer attribute is set). If none are possible, this layer won't show up
This tagrendering is only visible in the popup if the following condition is met: `<a href='https://wiki.openstreetmap.org/wiki/Key:has_presets' target='_blank'>has_presets</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:has_presets%3Dyes' target='_blank'>yes</a>`
This tagrendering is only visible in the popup if the following condition is met: `<a href='https://wiki.openstreetmap.org/wiki/Key:has_note_layer' target='_blank'>has_note_layer</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:has_note_layer%3Dyes' target='_blank'>yes</a>`
If the import-button moves OSM points, the imported way points or conflates, a preview is shown. This layer defines how this preview is rendered. This layer cannot be included in a theme.
Layer rendering the way to split in the 'splitRoadWizard'. This one is used instead of the variable rendering by the themes themselves, as they might not always be very visible
- This layer is shown at zoomlevel **1** and higher
- This layer can **not** be included in a theme. It is solely used by [special renderings](SpecialRenderings.md) showing a minimap with custom data.
A meta-layer which contains one single feature, namely the bounding box of the current map view. This can be used to trigger special actions. If a popup is defined for this layer, this popup will be accessible via an extra button on screen.
- *The language was set via an URL-parameter and cannot be set by the user.²* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:__url_parameter_initialized:language'target='_blank'>__url_parameter_initialized:language</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:__url_parameter_initialized:language%3Dyes'target='_blank'>yes</a>
- *{link(Open your inbox,&LBRACE_backend&RBRACE/messages/inbox,,)}* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:_unreadMessages'target='_blank'>_unreadMessages</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:_unreadMessages%3D0'target='_blank'>0</a>
- *{link(<bclass='alert'>You have &LBRACE_unreadMessages&RBRACE</b><br/>Open your inbox,&LBRACE_backend&RBRACE/messages/inbox,,)}* corresponds with _unreadMessages>0
This tagrendering is only visible in the popup if the following condition is met: `_theme:backgroundLayer!= & _theme:backgroundLayer~.+ & mapcomplete-preferred-background-layer~.+`
- *Use the default background layer* corresponds with mapcomplete-preferred-background-layer=
- *Use OpenStreetMap-carto as default layer* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-preferred-background-layer'target='_blank'>mapcomplete-preferred-background-layer</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-preferred-background-layer%3Dosm'target='_blank'>osm</a>
- *Use aerial imagery as default background* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-preferred-background-layer'target='_blank'>mapcomplete-preferred-background-layer</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-preferred-background-layer%3Dphoto'target='_blank'>photo</a>
- *Use a non-openstreetmap based map as default background* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-preferred-background-layer'target='_blank'>mapcomplete-preferred-background-layer</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-preferred-background-layer%3Dmap'target='_blank'>map</a>
- *Use the current background layer (<spanclass='code'>{__current_background}</span>) as default background* corresponds with mapcomplete-preferred-background-layer=
- *Use background layer <spanclass='code'>{mapcomplete-preferred-background-layer}</span> as default background* corresponds with mapcomplete-preferred-background-layer~.+
This question is not meant to be placed on an OpenStreetMap-element; however it is used in the user information panel to ask which license the user wants
- *Pictures you take will be licensed with <b>CC0</b> and added to the public domain. This means that everyone can use your pictures for any purpose. <spanclass='subtle'>This is the default choice.</span>* corresponds with mapcomplete-pictures-license=
- _This option cannot be chosen as answer_
- *Pictures you take will be licensed with <b>CC0</b> and added to the public domain. This means that everyone can use your pictures for any purpose.* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-pictures-license'target='_blank'>mapcomplete-pictures-license</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-pictures-license%3DCC0'target='_blank'>CC0</a>
- *Pictures you take will be licensed with <b>CC-BY 4.0</b> which requires everyone using your picture that they have to attribute you* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-pictures-license'target='_blank'>mapcomplete-pictures-license</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-pictures-license%3DCC-BY 4.0'target='_blank'>CC-BY 4.0</a>
- *Pictures you take will be licensed with <b>CC-BY-SA 4.0</b> which means that everyone using your picture must attribute you and that derivatives of your picture must be reshared with the same license.* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-pictures-license'target='_blank'>mapcomplete-pictures-license</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-pictures-license%3DCC-BY-SA 4.0'target='_blank'>CC-BY-SA 4.0</a>
- *Never show the tags.* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_tags'target='_blank'>mapcomplete-show_tags</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_tags%3Dno'target='_blank'>no</a>
- *Show the tags that will be applied once I have made {__userjourney_tagsVisibleAt} changesets* corresponds with mapcomplete-show_tags=
- *Show the tags that will be applied when making a change* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_tags'target='_blank'>mapcomplete-show_tags</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_tags%3Dyes'target='_blank'>yes</a>
- *Show the tags that will be applied when making a change and show the tags table on every feature* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_tags'target='_blank'>mapcomplete-show_tags</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_tags%3Dfull'target='_blank'>full</a>
- *Show all questions in the infobox together* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show-all-questions'target='_blank'>mapcomplete-show-all-questions</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show-all-questions%3Dtrue'target='_blank'>true</a>
- *Show questions one-by-one* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show-all-questions'target='_blank'>mapcomplete-show-all-questions</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show-all-questions%3Dfalse'target='_blank'>false</a>
- *Show a crosshair in the center of the map (when zoomed in above level 17)* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_crosshair'target='_blank'>mapcomplete-show_crosshair</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_crosshair%3Dyes'target='_blank'>yes</a>
- *Do not show a crosshair in the center of the map* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_crosshair'target='_blank'>mapcomplete-show_crosshair</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_crosshair%3Dno'target='_blank'>no</a>
- *Do not show a crosshair in the center of the map* corresponds with mapcomplete-show_crosshair=
- *Allow to rotate the map* corresponds with mapcomplete-fixate-north=
- *Always keep north pointing up* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-fixate-north'target='_blank'>mapcomplete-fixate-north</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-fixate-north%3Dyes'target='_blank'>yes</a>
- *Don't show a button to quickly change translations* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dfalse'target='_blank'>false</a>
- *Show a button to quickly open translations when using MapComplete on a big screen* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dtrue'target='_blank'>true</a>
- *Always show the translation buttons, including on mobile* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dmobile'target='_blank'>mobile</a>
- *Click the 'translate'-icon next to a string to enter or update a piece of text. You need a Weblate-account for this. Create one with your OSM-username to automatically unlock translation mode.* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dyes'target='_blank'>yes</a> | <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dtrue'target='_blank'>true</a> | <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode'target='_blank'>mapcomplete-translation-mode</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dmobile'target='_blank'>mobile</a>
This tagrendering is only visible in the popup if the following condition is met: `<a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode' target='_blank'>mapcomplete-translation-mode</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dyes' target='_blank'>yes</a> | <a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode' target='_blank'>mapcomplete-translation-mode</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dtrue' target='_blank'>true</a> | <a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode' target='_blank'>mapcomplete-translation-mode</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dmobile' target='_blank'>mobile</a>`
This tagrendering is only visible in the popup if the following condition is met: `(<a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode' target='_blank'>mapcomplete-translation-mode</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dtrue' target='_blank'>true</a> | <a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-translation-mode' target='_blank'>mapcomplete-translation-mode</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-translation-mode%3Dmobile' target='_blank'>mobile</a>) & _translation_links~.+`
- *A link to your Mastodon-profile has been been found: <ahref='{_mastodon_link}'target='_blank'rel='noopener'>{_mastodon_link}</a>* corresponds with _mastodon_link~.+
- *We found a link to what looks to be a mastodon account, but it is unverified. <ahref='https://www.openstreetmap.org/profile/edit'target='_blank'rel='noopener'>Edit your profile description</a> and place the following there: <spanclass='code'><a href="{_mastodon_candidate}" rel="me">Mastodon</a>* corresponds with _mastodon_candidate~.+
- *Show debug info* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_debug'target='_blank'>mapcomplete-show_debug</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_debug%3Dyes'target='_blank'>yes</a>
- *Don't show debug info* corresponds with <ahref='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_debug'target='_blank'>mapcomplete-show_debug</a>=<ahref='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_debug%3Dno'target='_blank'>no</a>
- *Don't show debug info* corresponds with mapcomplete-show_debug=
This tagrendering is only visible in the popup if the following condition is met: `<a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_debug' target='_blank'>mapcomplete-show_debug</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_debug%3Dyes' target='_blank'>yes</a>`
This tagrendering is only visible in the popup if the following condition is met: `<a href='https://wiki.openstreetmap.org/wiki/Key:mapcomplete-show_debug' target='_blank'>mapcomplete-show_debug</a>=<a href='https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-show_debug%3Dyes' target='_blank'>yes</a>`
This document is autogenerated from [src/Customizations/AllKnownLayouts.ts](https://github.com/pietervdvn/MapComplete/blob/develop/src/Customizations/AllKnownLayouts.ts)
