diff --git a/libnm-util/nm-setting-team-port.c b/libnm-util/nm-setting-team-port.c
index 0d650ecefd..b85e8aa7e2 100644
--- a/libnm-util/nm-setting-team-port.c
+++ b/libnm-util/nm-setting-team-port.c
@@ -163,12 +163,21 @@ nm_setting_team_port_class_init (NMSettingTeamPortClass *setting_class)
 	 * NMSettingTeamPort:config:
 	 *
 	 * The config of team port
+	 * JSON configuration for the team port.
+	 * The property should contain raw JSON configuration data
+	 * suitable for teamd, because the value is passed directly to
+	 * teamd. If not specified, the default configuration is used.
+	 * See man teamd.conf for the format details.
 	 **/
 	g_object_class_install_property
 		(object_class, PROP_CONFIG,
 		 g_param_spec_string (NM_SETTING_TEAM_PORT_CONFIG,
 		                      "Config",
-		                      "The config of team port",
+		                      "JSON configuration for the team port. "
+		                      "The property should contain raw JSON configuration data "
+		                      "suitable for teamd, because the value is passed directly to "
+		                      "teamd. If not specified, the dafault configuration is used. "
+		                      "See man teamd.conf for the format details.",
 		                      NULL,
 		                      G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
 }
diff --git a/libnm-util/nm-setting-team.c b/libnm-util/nm-setting-team.c
index d52eeac2b4..fa0cebb3ba 100644
--- a/libnm-util/nm-setting-team.c
+++ b/libnm-util/nm-setting-team.c
@@ -241,13 +241,21 @@ nm_setting_team_class_init (NMSettingTeamClass *setting_class)
 	/**
 	 * NMSettingTeam:config:
 	 *
-	 * The config of team network interface
+	 * JSON configuration for the team network interface.
+	 * The property should contain raw JSON configuration data
+	 * suitable for teamd, because the value is passed directly to
+	 * teamd. If not specified, the default configuration is used.
+	 * See man teamd.conf for the format details.
 	 **/
 	g_object_class_install_property
 		(object_class, PROP_CONFIG,
 		 g_param_spec_string (NM_SETTING_TEAM_CONFIG,
 		                      "Config",
-		                      "The config of team network interface",
+		                      "JSON configuration for the team network interface. "
+		                      "The property should contain raw JSON configuration data "
+		                      "suitable for teamd, because the value is passed directly to "
+		                      "teamd. If not specified, the default configuration is used. "
+		                      "See man teamd.conf for the format details.",
 		                      NULL,
 		                      G_PARAM_READWRITE | NM_SETTING_PARAM_SERIALIZE));
 }