Tagging for the renderer

From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — Tagging for the renderer
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް
Buildings, barriers and landuses mapped in way not to resemble reality but to render in default map display as 3D image of building
The canonical example of what not to do

The phrase "Tagging for the renderer" and especially "Don't tag for the renderer" has a long history within OSM. More broadly it is sometimes phrased as "Don't map for the renderer" since it's not just about tagging. In any case the phrase is often misunderstood. The meaning of it is probably closer to the following:

Don't deliberately enter data incorrectly for the renderer

but we need to live with the phrase that gets used most often. The basic good practice principle is that you avoid using incorrect tags, or otherwise skewing the data you enter, to make things show up in a specific way on the map rendering.


For example, if landuse=industrial shows up as a pink area on one of maps, and you have a flowerbed full of pink roses, then tagging your flowerbed as landuse=industrial would be incorrect and must be avoided. Instead, you should accurately tag the flowerbed with the type of plants, and improve the renderers instead so that they understand how to show it.

Another example is when someone abbreviates names, or puts spaces into them like T o w n H a l l S t r e e t to ensure that the names show up "nice" on the one particular map. This should be avoided as it is tagging for the renderer. It breaks the search, other map styles, and, in addition, map prettiness is subjective. It should be the renderers' job to abbreviate street names or interspace characters.

CERN particle accelerator rings were at one point tagged as highway=trunk and highway=primary (with tunnel=yes) even though they aren't major roads of any kind. It has since been retagged to correct highway=path/tunnel=yes/access=restricted and later changed to highway=corridor + access=private + tunnel=yes.

To collect information about how buildings look use 3D tagging rather than map fake buildings, barriers and landuses that in some renderers will look like 3D image of building.

The Great Lakes were tagged as natural=coastline, even though that is for the ocean, because the coastline ways are rendered at low zoom levels. They were changed to water=lake and as a result disappeared from the default map layer. Renderers should show big lakes at low zoom levels, without tagging them as seas.

Sometimes mangroves are tagged as natural=wood or landuse=forest to obtain a green area in the render. The correct tagging is natural=wetland + wetland=mangrove.

General meaning

The phrase usually refers to renderers, but it also applies for routing and geocoding and other uses of the data. Further examples could be conceived for these as well.

Also, although the most common form of data skewing would be misuse of tags, this rule can apply to the manner in which elements are geometrically arranged.


A misunderstanding comes when people say that you shouldn't tag something "for the renderer" even though the tags being used are accurate and not misleading. For example, if a specialist map renders a particular specialist tag (e.g. the nesting site of rare birds) then using the tags the renderer understands is a perfectly reasonable thing to do, even if they haven't been formally "approved".