Mirror id-tagging-schema
Find a file
dependabot[bot] e73d5194b9
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
Bump eslint from 10.7.0 to 10.8.0 (#2642)
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-08-03 08:50:42 +02:00
.github assign permissions specifically in deploy-preview.yml (#2581) 2026-07-28 11:18:25 +02:00
.vscode rename files, update docs, and update config for schema-builder merge 2026-07-09 19:45:41 +10:00
data Add office=translator to office combobox (#2635) 2026-08-03 07:19:08 +02:00
dist npm run dist translations 2026-07-08 19:29:15 +02:00
schemas format JSON schema files 2026-07-28 15:31:23 +02:00
scripts fix bug with stringsCrossReference (#2608) 2026-07-28 12:54:24 +02: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 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 confusing mix of callbacks and promises 2026-07-15 06:56:46 +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 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 eslint from 10.7.0 to 10.8.0 (#2642) 2026-08-03 08:50:42 +02:00
package.json convert the remaining build scripts to typescript (#2545) 2026-07-24 13:41:50 +02:00
README.md update mention of osmfeatures (#2561) 2026-07-19 17:36:14 +02:00
SCHEMA.md fix bug with stringsCrossReference (#2608) 2026-07-28 12:54:24 +02:00
tsconfig.json allow typescript to be used for the build scripts 2026-07-15 06:43:37 +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.