diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7967d04d3..789f5139e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -28,6 +28,113 @@ _Breaking changes, which may affect downstream projects or sites that embed iD,
 [@xxxx]: https://github.com/xxxx
 -->
 
+# 2.10.0
+##### Jul 26, 2018
+
+#### :mega: Release Highlights
+* :memo: You can now create, comment on, and resolve OpenStreetMap notes from within iD! This work was done as part of [Thomas Hervey's 2018 Google Summer of Code project](https://www.openstreetmap.org/user/Thomas_Hervey/diary/44449). Thanks [@thomas-hervey]!<br/>
+_Activate the OpenStreetMap notes layer by opening the Map Data pane (shortcut <kbd>F</kbd>)_
+* :wrench: We've added a new Detach Node operation to remove a tagged node from a way. Thanks [@Psigio]!<br/>
+_With a node selected, use the right-click edit menu to find the Detach command (shortcut <kbd>E</kbd>)_
+* :arrow_upper_right: The photo viewer (Mapillary, OpenStreetCam, and Bing Streetside) is now resizeable by dragging any of its edges.  Thanks [@kratico]!
+_Try activating one of the streetlevel photo layers (shortcut <kbd>F</kbd>) and resizing the viewer._
+
+[@thomas-hervey]: https://github.com/thomas-hervey
+[@Psigio]: https://github.com/Psigio
+[@kratico]: https://github.com/kratico
+
+#### :tada: New Features
+* Add support for OpenStreetMap notes ([#2629], [#5107], [#5162], thanks [@thomas-hervey])
+* Add Detach Node operation ([#4320], [#5127], thanks [@Psigio])
+* Add support for high resolution image tile sizes
+  * This improves the appearance of the Mapbox Satellite layer and fixes the display of MTB-Norway layer ([#5179])
+  * :warning: We refactored `d3.geo.tile`->`utilTiler`, `scaleExtent`->`zoomExtent` ([#5104], [#5148], thanks [@thomas-hervey])
+  * :warning: `context.loadTiles` and a few other functions have changed arity - they no longer require a `dimensions` argument
+* Add ability to resize Mapillary / OpenStreetCam / Bing Streetside photo viewer ([#5138], [#4930], thanks [@kratico])
+* Add "View on Bing Maps" link and Forward/Backward controls to Bing Streetside ([#5125])
+
+[#5179]: https://github.com/openstreetmap/iD/issues/5179
+[#5162]: https://github.com/openstreetmap/iD/issues/5162
+[#5148]: https://github.com/openstreetmap/iD/issues/5148
+[#5138]: https://github.com/openstreetmap/iD/issues/5138
+[#5127]: https://github.com/openstreetmap/iD/issues/5127
+[#5125]: https://github.com/openstreetmap/iD/issues/5125
+[#5107]: https://github.com/openstreetmap/iD/issues/5107
+[#5104]: https://github.com/openstreetmap/iD/issues/5104
+[#4930]: https://github.com/openstreetmap/iD/issues/4930
+[#4320]: https://github.com/openstreetmap/iD/issues/4320
+[#2629]: https://github.com/openstreetmap/iD/issues/2629
+[@thomas-hervey]: https://github.com/thomas-hervey
+[@Psigio]: https://github.com/Psigio
+[@kratico]: https://github.com/kratico
+
+#### :sparkles: Usability
+* Update viewfield to match bearing of Mapillary viewer when viewing panoramic images ([#5161], thanks [@kratico])
+* Increase photo viewer default size for large screens ([#5139], thanks [@kratico])
+* Improve Mapillary viewer attribution display ([#5137], thanks [@kratico])
+* Improve visibility and styling for `footway=crossing` and other special paths ([#5126])
+
+[#5161]: https://github.com/openstreetmap/iD/issues/5161
+[#5139]: https://github.com/openstreetmap/iD/issues/5139
+[#5137]: https://github.com/openstreetmap/iD/issues/5137
+[#5126]: https://github.com/openstreetmap/iD/issues/5126
+[@kratico]: https://github.com/kratico
+
+#### :bug: Bugfixes
+* Make sure railway bridges with a `service=*` tag render with dark casing ([#5159])
+* Properly save and restore OSM data caches when entering/leaving the walkthrough
+* Avoid errors if Mapillary viewer could not be initialized
+* Support reversal of more direction tags (`conveying`, `priority`, etc.) in Reverse action ([#5121])
+* Fix event management of the spinner - it was possible for it to get stuck spinning ([#5107-comment])
+* Add doublequotes to iD-sprite input file param so builds work on Windows ([#5077])
+
+[#5159]: https://github.com/openstreetmap/iD/issues/5159
+[#5121]: https://github.com/openstreetmap/iD/issues/5121
+[#5107-comment]: https://github.com/openstreetmap/iD/pull/5107#issuecomment-401617938
+[#5077]: https://github.com/openstreetmap/iD/issues/5077
+
+#### :hourglass: Performance
+* Use XHR instead of JSONP wherever possible ([#5123], [#5040], thanks [@tomhughes])
+* Check Esri Tilemaps to avoid extra requests for unavailable imagery ([#5116], [#5029], thanks [@jgravois])
+
+[#5123]: https://github.com/openstreetmap/iD/issues/5123
+[#5116]: https://github.com/openstreetmap/iD/issues/5116
+[#5040]: https://github.com/openstreetmap/iD/issues/5040
+[#5029]: https://github.com/openstreetmap/iD/issues/5029
+[@tomhughes]: https://github.com/tomhughes
+[@jgravois]: https://github.com/jgravois
+
+#### :mortar_board: Walkthrough / Help
+* Add section about OpenStreetMap notes to Help pane ([#5162], thanks [@thomas-hervey])
+
+[@thomas-hervey]: https://github.com/thomas-hervey
+
+#### :rocket: Presets
+* Add `aeroway=aerodrome` to Military Airfield preset, adjust terms ([#5164])
+* Add `passenger_information_display` to Bus, Tram platform presets ([#5142], thanks [@AndreasHae])
+* Add `levels` field to `shop=kiosk` preset ([#5131], [#5133], thanks [@vershwal])
+* Add `site_type` to Archaeological Site preset ([#5124], thanks [@JamesKingdom])
+* Add `network` field to ATM preset ([#5119], thanks [@JamesKingdom])
+* Add `cash_in` field to ATM preset ([#5118], thanks [@JamesKingdom])
+* Improve search terms for Entrance preset ([#5130], thanks [@tohaklim])
+* Add `capacity` field to `playground=swing` preset ([#5120], thanks [@tordans])
+
+[#5164]: https://github.com/openstreetmap/iD/issues/5164
+[#5142]: https://github.com/openstreetmap/iD/issues/5142
+[#5131]: https://github.com/openstreetmap/iD/issues/5131
+[#5133]: https://github.com/openstreetmap/iD/issues/5133
+[#5124]: https://github.com/openstreetmap/iD/issues/5124
+[#5119]: https://github.com/openstreetmap/iD/issues/5119
+[#5118]: https://github.com/openstreetmap/iD/issues/5118
+[#5130]: https://github.com/openstreetmap/iD/issues/5130
+[#5120]: https://github.com/openstreetmap/iD/issues/5120
+[@AndreasHae]: https://github.com/AndreasHae
+[@vershwal]: https://github.com/vershwal
+[@JamesKingdom]: https://github.com/JamesKingdom
+[@tohaklim]: https://github.com/tohaklim
+[@tordans]: https://github.com/tordans
+
+
 # 2.9.2
 ##### Jun 28, 2018