diff --git a/docs/port-bindings.md b/docs/port-bindings.md
index a9ff80e4..a9b973fd 100644
--- a/docs/port-bindings.md
+++ b/docs/port-bindings.md
@@ -37,3 +37,20 @@ container_id = cli.create_container(
     })
 )
 ```
+
+If trying to bind several IPs to the same port, you may use the following syntax:
+```python
+cli.create_host_config(port_bindings={
+    1111: [
+        ('192.168.0.100', 1234),
+        ('192.168.0.101', 1234)
+    ]
+})
+```
+
+Similarly for several container ports bound to a single host port:
+```python
+cli.create_host_config(port_bindings={
+    1111: [1234, 4567]
+})
+```