From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — Tags
Mf tag.svg

A Tag consists of 'Key' and a 'Value'. Each tag describes a specific feature of a data element (nodes, ways and relations) or changesets. Both the key and value are free format text fields. In practice, however, there are agreed conventions of how tags are used for most common purposes.

Key can be modified with a prefix, infix or suffix namespace to further qualify it. Common namespaces are language specification and a date namespace specification for name keys.

Keys and values

Each tag has only a key and value. Tags are written in OSM documentation as key=value.

  • The key describes a broad class of features (for example, highways or names).
  • The value details the specific feature that was generally classified by the key (e.g. highway=motorway). If multiple values would be needed for one key the semi-colon value separator may be used in some situations.

Here are a few examples of how keys and values are used in practice:

  • highway=residential a tag with a key of 'highway' and a value of 'residential' which should be used on a way to indicate a road along which people live.
  • name=Park Avenue a tag for which the value field is used to convey the name of the particular street
  • maxspeed=50 a tag whose value is a numeric speed in km/h (or in miles per hour if the unit is provided with a suffix 'mph'). Metric units are the default.
  • maxspeed:forward=* a key that includes a namespace for 'maxspeed' to further distinguish its meaning.
  • name:de:1953-1990=Ernst-Thälmann-Straße a tag with the 'name' key suffixed namespaces to specify the German name which was valid in some years.

Finding your tag

The following resources are often used to find an appropriate tag or explore tag usage:

Use in an editor

Some OSM editors (for example iD, Potlatch 2) hide the tags of objects by default, making them not directly editable; instead users fill-in a form. However, likely all tags can be displayed and edited by entering an "advanced" mode of your editor. For the example editors this feature is named "All tags" (bottom left), in iD, respectively "Advanced", in Potlatch 2.

Node · Way · Area · Relation (members and roles) · Tag (key and value)