Mirror id-tagging-schema
Find a file
Kyℓe Hensel 3c780a1910
Some checks failed
Interim Build / Build and Deploy Interim State (push) Has been cancelled
Code Style Checks / Check file endings (push) Has been cancelled
Code Style Checks / Check for code formatting mistakes (push) Has been cancelled
Code Style Checks / Check for spelling errors (push) Has been cancelled
Release Drafter / update_release_draft (push) Has been cancelled
Build and Deploy Staging Instance / build-deploy (push) Has been cancelled
Test / test (push) Has been cancelled
fix minor bugs in the build scripts (#2446)
2026-07-12 09:10:39 +02:00
.github handle "build" label in release-drafter (#2441) 2026-07-10 08:59:57 +02:00
.vscode rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
data Set public transport presets with no defined vehicle mode (bus, tram etc.) to be non-searchable (#2343) 2026-07-11 19:37:24 +02:00
dist npm run dist translations 2026-07-08 19:29:15 +02:00
schemas rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
scripts fix minor bugs in the build scripts (#2446) 2026-07-12 09:10:39 +02:00
.editorconfig tweak code formatting rules 2022-01-25 14:04:40 +01:00
.gitattributes make GitHub recognise that this repo contains mostly JSON, not JS (#1989) 2026-03-09 17:25:48 +01:00
.gitignore rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
.nvmrc add .nvmrc file 2023-03-13 12:55:17 +01:00
.prettierignore Fix: cross-platform compatibility for npm run lint on Windows (#1969) 2026-03-03 11:46:18 +01:00
.prettierrc Update and run Prettier (#1144) 2024-02-28 09:15:22 +01:00
.travis.yml Add travis.yml 2020-11-25 14:57:24 -05:00
CHANGELOG.md merge changelogs into a single chronological one 2026-07-09 16:26:49 +02:00
CONTRIBUTING.md rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
eslint.config.js fix minor bugs in the build scripts (#2446) 2026-07-12 09:10:39 +02:00
GOVERNANCE.md document new OSMF funding for work by @matkoniecz (Mateusz Konieczny) (#2348) 2026-06-23 11:14:10 +02:00
GUIDELINES.md rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
ICONS.md Fix broken links on icon previews (#328) 2026-06-29 07:57:31 +02:00
LICENSE.md Remove copyright year in LICENSE.md (#2111) 2026-03-31 12:39:25 +02:00
MIGRATION_GUIDE.md add missing parenthesis 2026-07-09 11:09:38 +02:00
netlify.toml Revert "Netlify preview: Add CORS for iD Staging deploy" (#2436) 2026-07-10 00:12:29 +02:00
package-lock.json Bump marky from 1.2.5 to 1.3.0 (#2439) 2026-07-10 08:45:41 +02:00
package.json merge the schema-builder repository into this repository (#2431) 2026-07-09 16:33:44 +02:00
README.md rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
SCHEMA.md fix typo SCHEMA.md 2026-07-10 21:33:13 +02:00
vitest.config.js rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00

test npm version

iD Tagging Schema

This is the directory of OpenStreetMap tagging data used by the iD editor and others. It includes presets, fields, deprecations, and more, recording various information about OpenStreetMap tagging, in a machine-readable format for easy use by editor software. It does this by abstracting and slightly simplifying OpenStreetMap's Folksonomy as documented on the OpenStreetMap Wiki, the community forum and other sources. The main goal is to allow OSM editing software to display the OSM data in a way that is intuitive and easy to understand for the user (i.e. such that they don't have to read the full documentation in order to use the respective tags). iD tagging schema is following community consensus rather than inventing new tagging methods.

Participate!

Background

OpenStreetMap itself does not have a formal rigid database schema, but relies on a tagging folksonomy instead.

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.

  • The OpenStreetMap wiki documents the current usage of tags, and hosts discussions about proposed new tags.
  • iD also incorporates preset data from the name-suggestion-index.
  • Other editors also include their own models of interpretations of OSM tags. See for example Vespucci's or JOSM's tagging presets.

Contributing

See the dedicated CONTRIBUTING page for information about this.