diff --git a/CHANGES.md b/CHANGES.md
index 28a3d55f..a3aa4a69 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,12 +1,12 @@
-# Unreleased
+# 2.9.0 (2018-06-13)
 
 - [NEW] Added functionality to test if a key is in a database as in `key in db`, overriding dict `__contains__` and checking in the remote database.
 - [NEW] Moved `create_query_index` and other query related methods to `CouchDatabase` as the `_index`/`_find` API is available in CouchDB 2.x.
 - [NEW] Support IAM authentication in replication documents.
+- [FIXED] Case where `Document` context manager would throw instead of creating a new document if no `_id` was provided.
 - [IMPROVED] Added support for IAM API key in `cloudant_bluemix` method.
-- [IMPROVED] Verified library operation on Python 3.6.3.
 - [IMPROVED] Shortened length of client URLs by removing username and password.
-- [FIXED] Case where `Document` context manager would throw instead of creating a new document if no `_id` was provided.
+- [IMPROVED] Verified library operation on Python 3.6.3.
 
 # 2.8.1 (2018-02-16)
 
diff --git a/VERSION b/VERSION
index dc3cd3a8..c8e38b61 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.8.2-SNAPSHOT
+2.9.0
diff --git a/docs/conf.py b/docs/conf.py
index c4e0c7f8..a59073af 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -58,9 +58,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '2.8.2-SNAPSHOT'
+version = '2.9.0'
 # The full version, including alpha/beta/rc tags.
-release = '2.8.2-SNAPSHOT'
+release = '2.9.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/src/cloudant/__init__.py b/src/cloudant/__init__.py
index 51018794..646cc41b 100644
--- a/src/cloudant/__init__.py
+++ b/src/cloudant/__init__.py
@@ -15,7 +15,7 @@
 """
 Cloudant / CouchDB Python client library API package
 """
-__version__ = '2.8.2-SNAPSHOT'
+__version__ = '2.9.0'
 
 # pylint: disable=wrong-import-position
 import contextlib