@hotosm/id

iD - friendly JavaScript editor for OpenStreetMap

Basics

• iD is a JavaScript OpenStreetMap editor.
• It's intentionally simple. It lets you do the most basic tasks while not breaking other people's data.
• It supports all popular modern desktop browsers: Chrome, Firefox, Safari, Opera, and Edge.
• Data is rendered with d3.js.

Participate!

• Read the project Code of Conduct and remember to be nice to one another.
• Read up on Contributing and the code style of iD.
• See open issues in the issue tracker if you're looking for something to do.
• Translate!
• Test a prerelease version of iD:
  • Stable mirror of release branch: https://ideditor-release.netlify.app
  • Development mirror of develop branch + latest translations: https://ideditor.netlify.app

Come on in, the water's lovely. More help? Ping Martin Raifer/tyr_asd or bhousel on:

• OpenStreetMap US Slack (#id channel)
• OpenStreetMap Discord (#id-and-rapid channel)
• OpenStreetMap IRC (irc.oftc.net, in #osm-dev)
• OpenStreetMap dev mailing list

Installation

Follow the steps in the how to get started guide on how to install, build and run iD locally.

License

iD is available under the ISC License. See the LICENSE.md file for more details.

iD also bundles portions of the following open source software.

• D3.js (BSD-3-Clause)
• CLDR (Unicode Consortium Terms of Use)
• editor-layer-index (CC-BY-SA 3.0)
• Font Awesome (CC-BY 4.0)
• Maki (CC0 1.0)
• Temaki (CC0 1.0)
• Röntgen icon set (CC-BY 4.0)
• Mapillary JS (MIT)
• iD Tagging Schema (ISC)
• name-suggestion-index (BSD-3-Clause)
• osm-community-index (ISC)

Thank you

Initial development of iD was made possible by a grant of the Knight Foundation.

Changelog

v2.34.0

2025-05-12

:sparkles: Usability & Accessibility

• Show full relation label as hover-text in membership editor, disambiguate relations with duplicate labels by appending the relation id ([#10942])
• More consistently round non-integer initial zoom when zooming in/out when using the zoom buttons or +/- keyboard shortcuts
• Render map points over vertices ([#11006])

:scissors: Operations

• Preserve the sum of certain tags (step_count, parking:*:capacity) during join operation ([#10492], thanks [@ChaitanyaKadu03])
• Preserve total value of parking:*:capacity tags during split operation by distributing it proportionally to the resulting ways ([#10492])
• A split operation will now only split the ways that contain all selected nodes when more than one node is selected ([#10997])

:camera: Street-Level

• Keep photo viewer open when disabling Panoramax overlay ([#10966])
• Don't de-select map feature when clicking on a street level photo ([#10959])
• Disable keyboard controls for all panorama viewers, allows to use regular mapping shortcuts while the viewer is focussed ([#11011])
• Keep active photo viewer state properly during changeset upload ([#10987]) and when switching between photos of different services

:white_check_mark: Validation

• Show unchanged tags of a deprecation rule explicitly in the validation warning ([#10104])

:bug: Bugfixes

• Fix removed tooltips from re-appearing when using keyboard navigation ([#9873])
• Only consider feature with proper lifecycle tags in "past/futures" layer ([#10943])
• Fix zoom level from resetting to the starting value when switching background imagery layer during the zoom transition
• Fix invalid single-noded ways from being created by a split operation under certain conditions when multiple nodes are selected ([#10997])
• Properly highlight changed features when they are hovered in the upload dialog's list of changes ([#10030])

:mortar_board: Walkthrough / Help

• Change background imagery of walkthrough tutorial to Bing (the previous source is not available anymore)

:rocket: Presets

• Suggest housenumber/housename values from surrounding areas ([#10946])

:hammer: Development

• Drop support for Node 18