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.
Keys and values
Each tag has only a key and value. Tags are written in OSM documentation as
- 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=* a tag for which the value field is used to convey the name of the particular street
- maxspeed=* a tag whose value is a numeric speed in km/h (or in miles per hour if the suffix 'mph' is provided). Metric units are the default (and do not need to be mentioned explicitly). Other units, such as miles per hour, knots, yard or pounds must be stated after the value. Where a regulation is specified in a particular unit then that unit should be used within the value field.
- maxspeed:winter=* a key that includes a Namespace for 'maxspeed' identifies a different value for maxspeed that applies only in winter.
Finding your tag
The following resources are often used to find an appropriate tag or explore tag usage:
- Map Features (a extensive list of the the most commonly used tags)
- Taginfo (A useful site to exploring current tag usage, including tag values that are not necessarily documented)
- OSM Semantic Network: a machine-readable structure containing the OSM tags
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 is named "All tags" respectively "Advanced").