Mirror id-tagging-schema
Find a file
Cao Junhao effa624bce
Some checks are pending
Interim Build / Build and Deploy Interim State (push) Waiting to run
Code Style Checks / Check file endings (push) Waiting to run
Code Style Checks / Check for code formatting mistakes (push) Waiting to run
Code Style Checks / Check for spelling errors (push) Waiting to run
Release Drafter / update_release_draft (push) Waiting to run
Build and Deploy Staging Instance / build-deploy (push) Waiting to run
Test / test (push) Waiting to run
Remove suggestion to add public_transport=station to all railway=station (#2878)
2026-09-17 14:52:31 +02:00
.github remove deprecation section from new tag issue template (#2837) 2026-09-15 11:57:26 +02:00
.vscode run prettier via eslint (#2683) 2026-08-15 07:20:40 +02:00
data Remove suggestion to add public_transport=station to all railway=station (#2878) 2026-09-17 14:52:31 +02:00
dist v7.2.0 2026-09-09 15:22:28 +02:00
schemas narrow down valid values with pattern, where possible (#2895) 2026-09-16 07:18:13 +10:00
scripts use arabic comma workaround also for terms of presets (#2852) 2026-09-16 17:18:15 +10:00
.editorconfig format JSON schema files 2026-07-28 15:31:23 +02: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 v7.2.0 2026-09-09 15:22:28 +02:00
CONTRIBUTING.md Move general rules to general guidelines, as it applies not only to submitting issues (#2856) 2026-09-11 14:11:20 +02:00
eslint.config.js simplify eslint config (#2747) 2026-08-22 13:54:59 +02:00
GOVERNANCE.md mention CoC in GOVERNANCE.md (#2880) 2026-09-15 11:50:38 +02:00
GUIDELINES.md Update GUIDELINES.md allowing non-US English in search terms (#2693) 2026-09-07 16:41:39 +02:00
ICONS.md Direct link for roentgen icons repository (#2489) 2026-07-14 11:56:50 +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 js-yaml from 4.3.1 to 5.4.1 (#2843) 2026-09-14 19:11:31 +10:00
package.json bump dev version number 2026-09-09 15:47:33 +02:00
README.md update mention of osmfeatures (#2561) 2026-07-19 17:36:14 +02:00
SCHEMA.md Fix example and documentation of geometry property in SCHEMA.md (#2860) 2026-09-15 11:31:49 +02:00
tsconfig.json remove shelljs dependency (#2706) 2026-08-15 06:09:26 +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

Kotlin Multiplatform

The westnordost/osmfeatures project, a component of StreetComplete, makes it easier to use this data with Android, iOS and 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.