diff --git a/docs/docs/segment-spotify.md b/docs/docs/segment-spotify.md
index 291519b1..7fbceddf 100644
--- a/docs/docs/segment-spotify.md
+++ b/docs/docs/segment-spotify.md
@@ -6,8 +6,10 @@ sidebar_label: Spotify
 
 ## What
 
-Show the currently playing song in the Spotify MacOS/Windows client.
-Be aware this can make the prompt a tad bit slower as it needs to get a response from the Spotify player.
+Show the currently playing song in the Spotify MacOS/Windows client.  
+On Windows, only the playing state is supported (no information when paused/stopped).  
+On macOS, all states are supported (playing/paused/stopped).  
+**Be aware this can make the prompt a tad bit slower as it needs to get a response from the Spotify player.**  
 
 ## Sample Configuration