diff --git a/content/library/api/state/state.md b/content/library/api/state/state.md
index 0895daf43..1f673acfb 100644
--- a/content/library/api/state/state.md
+++ b/content/library/api/state/state.md
@@ -146,6 +146,7 @@ with st.form(key='my_form'):
 
 ### Caveats and limitations
 
+- Streamlist Session State is tied to the socket connection so when you refresh the browser the socket is killed and renewed so state is reset. A user navigating links in Markdown also results in session reset for the same reason. 
 - Only the `st.form_submit_button` has a callback in forms. Other widgets inside a form are not allowed to have callbacks.
 - `on_change` and `on_click` events are only supported on input type widgets.
 - Modifying the value of a widget via the Session state API, after instantiating it, is not allowed and will raise a `StreamlitAPIException`. For example: