iD Tagging Schema

This is the directory of OpenStreetMap tagging data used by the iD editor. It includes presets, fields, deprecations, and more.

Background

OpenStreetMap itself does not have a formal tagging schema, but editing tools need to know how tags are used in order to facilitate mapping. This Tagging Schema fills that need, but with a number of caveats:

This isn't authoritative or definitive
Tagging interpretations may vary from mapper to mapper, place to place, and over time
Our primary aim is to serve the needs of iD mappers (but other tools are welcome to use this too)
We support tags based on practicality, usage, and community approval
Sometimes there are reasons we can't support a tag even if it's used or approved

Usage

Java/Android

The westnordost/osmfeatures project, a component of StreetComplete, makes it easier to use this data with Android or other Java platforms.

Related Projects

iD also incorporates preset data from the name-suggestion-index.

Contributing

iD's code of conduct and privacy policy also apply to this project.

Making Changes

Documentation for the data formats is located with the schema-builder package, which is the technical basis of this project. To make a change, update a file within the data folder and rebuild by running npm run build in your terminal.