diff --git a/CHANGES.rst b/CHANGES.rst
index a25e9ffb..761892c8 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,10 +1,10 @@
-2.5.0 (Unreleased)
+2.5.0 (2017-07-06)
 ==================
-- [FIXED] Fixed crash caused by non-UTF8 chars in ddocs
+- [FIXED] Fixed crash caused by non-UTF8 chars in design documents.
 - [FIXED] Fixed ``TypeError`` when setting revision limits on Python>=3.6.
 - [FIXED] Fixed the ``exists()`` double check on ``client.py`` and ``database.py``.
 - [FIXED] Fixed Cloudant exception code 409 with 412 when creating a database that already exists.
-- [FIXED] Catch error if ``throw_on_exists`` flag is ``False`` for document create.
+- [FIXED] Catch error if ``throw_on_exists`` flag is ``False`` for creating a document.
 - [FIXED] Fixed /_all_docs call where ``keys`` is an empty list.
 - [FIXED] Issue where docs with IDs that sorted lower than 0 were not returned when iterating through _all_docs.
 
diff --git a/docs/conf.py b/docs/conf.py
index 6099c07d..8db31f57 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -58,9 +58,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '2.5.0.dev'
+version = '2.5.0'
 # The full version, including alpha/beta/rc tags.
-release = '2.5.0.dev'
+release = '2.5.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/setup.py b/setup.py
index beeb376f..f29f338a 100644
--- a/setup.py
+++ b/setup.py
@@ -29,7 +29,7 @@
     'include_package_data': True,
     'install_requires': requirements,
     'name': 'cloudant',
-    'version': '2.5.0.dev',
+    'version': '2.5.0',
     'author': 'IBM',
     'author_email': 'alfinkel@us.ibm.com',
     'url': 'https://github.com/cloudant/python-cloudant',
diff --git a/src/cloudant/__init__.py b/src/cloudant/__init__.py
index 9400ab2a..6ddd584f 100644
--- a/src/cloudant/__init__.py
+++ b/src/cloudant/__init__.py
@@ -15,7 +15,7 @@
 """
 Cloudant / CouchDB Python client library API package
 """
-__version__ = '2.5.0.dev'
+__version__ = '2.5.0'
 
 # pylint: disable=wrong-import-position
 import contextlib