diff --git a/config/options_check.go b/config/options_check.go
index 8d252cf3d..92a57b80c 100644
--- a/config/options_check.go
+++ b/config/options_check.go
@@ -28,11 +28,11 @@ var reKeyPath = regexp.MustCompile(`\[\d+\]`)
 var (
 	// options that were deprecated in the config
 	removedConfigFields = map[string]string{
-		"idp_service_account":            "",
-		"idp_refresh_directory_timeout":  "",
-		"idp_refresh_directory_interval": "",
-		"idp_qps":                        "",
-		"routes.allowed_groups":          "",
+		"idp_service_account":            "https://docs.pomerium.com/docs/overview/upgrading#idp-directory-sync",
+		"idp_refresh_directory_timeout":  "https://docs.pomerium.com/docs/overview/upgrading#idp-directory-sync",
+		"idp_refresh_directory_interval": "https://docs.pomerium.com/docs/overview/upgrading#idp-directory-sync",
+		"idp_qps":                        "https://docs.pomerium.com/docs/overview/upgrading#idp-directory-sync",
+		"routes.allowed_groups":          "https://docs.pomerium.com/docs/overview/upgrading#idp-groups-policy",
 	}
 
 	// mapstructure has issues with embedded protobuf structs that we should ignore