diff --git a/CHANGELOG.md b/CHANGELOG.md
index caf8bf9df..f3445ed97 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,11 +2,12 @@
 All notable changes to this project will be documented in this file, following the suggestions of [Keep a CHANGELOG](http://keepachangelog.com/). This project adheres to [Semantic Versioning](http://semver.org/).
 
 
-## [Unreleased]
+## [v0.9.0] - 2016-10-05
 ### Added
 - lazy representation parameter that only builds & updates the representation when visible
 - chainname based color scheme
 - BondHash class to quickly get atoms connected to an atom
+- SpatialHash class to quickly get neighboring atoms/points
 - XmlParser parameter to use the browser's DOMParser
 - attachment (top, middle, bottom; left, center, right) for LabelRepresentation/TextBuffer
 - border color and width for LabelRepresentation/TextBuffer
@@ -15,6 +16,8 @@ All notable changes to this project will be documented in this file, following t
 - PubchemDatasource to load cid as sdf, pubchem://16490
 - basic entity support (type, description, chain mapping; mmcif, mmtf)
 - entitytype, moleculetype, chainid, polymer color schemes
+- ShaderRegistry, DecompressorRegistry
+- box display for "axes" representation
 
 ### Changed
 - ResidueindexColorMaker colorscale domain on a per chain basis
@@ -23,6 +26,7 @@ All notable changes to this project will be documented in this file, following t
 - ignore bonds that are defined multiple times in PDB parser
 - updated mmtf lib to v1.0
 - use npm as the build system
+- complete list of ion and saccharide group names
 
 ### Removed
 - gulp as the build system
@@ -198,7 +202,7 @@ All notable changes to this project will be documented in this file, following t
 - Initial release
 
 
-[Unreleased]: https://github.com/arose/ngl/compare/v0.8...HEAD
+[v0.9.0]: https://github.com/arose/ngl/compare/v0.8...v0.9.0
 [v0.8]: https://github.com/arose/ngl/compare/v0.7.1a...v0.8
 [v0.7.1a]: https://github.com/arose/ngl/compare/v0.7.1...v0.7.1a
 [v0.7.1]: https://github.com/arose/ngl/compare/v0.7...v0.7.1
diff --git a/README.md b/README.md
index 629b2bc48..0965a969e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 
 [![License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/arose/ngl/blob/master/LICENSE)
-[![Version](http://img.shields.io/badge/version-0.8-blue.svg?style=flat)](https://github.com/arose/ngl/releases/tag/v0.8)
+[![Version](http://img.shields.io/badge/version-0.9.0-blue.svg?style=flat)](https://github.com/arose/ngl/releases/tag/v0.9.0)
 [![Changelog](https://img.shields.io/badge/changelog--lightgrey.svg?style=flat)](https://github.com/arose/ngl/blob/master/CHANGELOG.md)