diff --git a/doc/api/http.markdown b/doc/api/http.markdown
index 577d7c2a50d..dfa97a74342 100644
--- a/doc/api/http.markdown
+++ b/doc/api/http.markdown
@@ -541,7 +541,8 @@ Alternatively, you could just opt out of pooling entirely using `agent:false`:
 ### agent.maxSockets
 
 By default set to 5. Determines how many concurrent sockets the agent can have
-open per host.
+open per origin. Origin is either a 'host:port' or 'host:port:localAddress'
+combination.
 
 ### agent.sockets