diff --git a/api/types/swarm/network.go b/api/types/swarm/network.go
index 0af0ce1daa..76b0bea1b5 100644
--- a/api/types/swarm/network.go
+++ b/api/types/swarm/network.go
@@ -25,10 +25,12 @@ const (
 
 // PortConfig represents the config of a port.
 type PortConfig struct {
-	Name          string             `json:",omitempty"`
-	Protocol      PortConfigProtocol `json:",omitempty"`
-	TargetPort    uint32             `json:",omitempty"`
-	PublishedPort uint32             `json:",omitempty"`
+	Name     string             `json:",omitempty"`
+	Protocol PortConfigProtocol `json:",omitempty"`
+	// TargetPort is the port inside the container
+	TargetPort uint32 `json:",omitempty"`
+	// PublishedPort is the port on the swarm hosts
+	PublishedPort uint32 `json:",omitempty"`
 }
 
 // PortConfigProtocol represents the protocol of a port.