diff --git a/website/source/docs/upgrade-specific.html.md b/website/source/docs/upgrade-specific.html.md
index 6a1dda2789..e1f16c1329 100644
--- a/website/source/docs/upgrade-specific.html.md
+++ b/website/source/docs/upgrade-specific.html.md
@@ -17,8 +17,17 @@ upgrade flow.
 
 ## Consul 1.7.0
 
-Consul 1.7.0 contains two major changes that may impact upgrades: 
-[stricter JSON decoding](#stricter-json-decoding) and [modified DNS outputs](#dns-ptr-record-output)
+Consul 1.7.0 contains three major changes that impact upgrades: 
+[stricter JSON decoding](#stricter-json-decoding), [modified DNS outputs](#dns-ptr-record-output), 
+and [backward-incompatible Session API changes](#session-api).
+
+### Session API
+Consul 1.7.0 introduced a backwards incompatible change to the Session API. 
+Queries to view or renew sessions from agents on earlier versions will be rejected.
+This impacts features and products including: Vault, the Enterprise snapshot agent, and locks.
+
+The issue occurs when clients are still running 1.6.4 or earlier but servers have been upgraded to 1.7.0 or 1.7.1. 
+For this reason, we recommend you upgrade directly to 1.7.2 when it is available as it will include a fix for this issue.
 
 ### Stricter JSON Decoding