diff --git a/CHANGELOG.md b/CHANGELOG.md
index ec9ed2c71..429310bd1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [3.1.8] - 2021-06-16
+
+### Fixes
+
+- urls were not working well in documentation [#979](https://github.com/distribworks/dkron/pull/979)
+- Improve upgrade doc [#980](https://github.com/distribworks/dkron/pull/980)
+- Update agent tags on config reload [#983](https://github.com/distribworks/dkron/pull/983)
+- Fix intermittent test false negative [#982](https://github.com/distribworks/dkron/pull/982)
+- Fix TLSRaftLayer init [#987](https://github.com/distribworks/dkron/pull/987)
+
+### Changes
+
+- Use Buildkit stable [#977](https://github.com/distribworks/dkron/pull/977)
+- Control errors on scheduler start [#978](https://github.com/distribworks/dkron/pull/978)
+
+
 ## [3.1.7] - 2021-05-29
 
 ### Features
@@ -25,8 +41,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Improve tests for http executor [#936](https://github.com/distribworks/dkron/pull/936)
 - Refactor processFilteredNodes for testing [#968](https://github.com/distribworks/dkron/pull/968)
 
-
-
 ## [3.1.6] - 2021-03-23
 
 ### Features