diff --git a/docs/user-guide/swarm-mode.md b/docs/user-guide/swarm-mode.md
index 4c6c79084..b17126bef 100644
--- a/docs/user-guide/swarm-mode.md
+++ b/docs/user-guide/swarm-mode.md
@@ -127,6 +127,8 @@ docker-machine ssh manager "docker service create \
 	emilevauge/whoami"
 ```
 
+NOTE: If using `docker stack deploy`, there is [a specific way that the labels must be defined in the docker-compose file](https://github.com/containous/traefik/issues/994#issuecomment-269095109).
+
 Check that everything is scheduled and started:
 
 ```sh