diff --git a/src/commands/proguard/upload.rs b/src/commands/proguard/upload.rs
index 4e623c7dc2..624b1b9fd4 100644
--- a/src/commands/proguard/upload.rs
+++ b/src/commands/proguard/upload.rs
@@ -59,13 +59,15 @@ pub fn make_command(command: Command) -> Command {
                 .short('u')
                 .value_name("UUID")
                 .value_parser(Uuid::parse_str)
+                .hide(true)
                 .help(
-                    "Explicitly override the UUID of the mapping file with another one.{n}\
-                     This should be used with caution as it means that you can upload \
-                     multiple mapping files if you don't take care.  This however can \
-                     be useful if you have a build process in which you need to know \
-                     the UUID of the proguard file before it was created.  If you upload \
-                     a file with a forced UUID you can only upload a single proguard file.",
+                    "[DEPRECATED] Manually override the UUID for the uploaded mapping.\n\
+                    We no longer recommend using this option. \
+                    If you use this option, you must use it consistently, and you must \
+                    ensure the UUID is generated deterministically based on the ProGuard \
+                    mapping. \n\
+                    If you need to know the UUID before upload, we recommend using the \
+                    `proguard uuid` command.",
                 ),
         )
 }
diff --git a/tests/integration/_cases/proguard/proguard-upload-help.trycmd b/tests/integration/_cases/proguard/proguard-upload-help.trycmd
index 9e5a586089..a61dcba74d 100644
--- a/tests/integration/_cases/proguard/proguard-upload-help.trycmd
+++ b/tests/integration/_cases/proguard/proguard-upload-help.trycmd
@@ -26,12 +26,6 @@ Options:
                                  flag is currently implemented only for selected subcommands.
                                  [aliases: --silent]
       --require-one              Requires at least one file to upload or the command will error.
-  -u, --uuid <UUID>              Explicitly override the UUID of the mapping file with another one.
-                                 This should be used with caution as it means that you can upload
-                                 multiple mapping files if you don't take care.  This however can be
-                                 useful if you have a build process in which you need to know the
-                                 UUID of the proguard file before it was created.  If you upload a
-                                 file with a forced UUID you can only upload a single proguard file.
   -h, --help                     Print help
 
 ```
diff --git a/tests/integration/_cases/upload_proguard/upload_proguard-help.trycmd b/tests/integration/_cases/upload_proguard/upload_proguard-help.trycmd
index 1a04f16588..990b4aa1cd 100644
--- a/tests/integration/_cases/upload_proguard/upload_proguard-help.trycmd
+++ b/tests/integration/_cases/upload_proguard/upload_proguard-help.trycmd
@@ -26,12 +26,6 @@ Options:
                                  flag is currently implemented only for selected subcommands.
                                  [aliases: --silent]
       --require-one              Requires at least one file to upload or the command will error.
-  -u, --uuid <UUID>              Explicitly override the UUID of the mapping file with another one.
-                                 This should be used with caution as it means that you can upload
-                                 multiple mapping files if you don't take care.  This however can be
-                                 useful if you have a build process in which you need to know the
-                                 UUID of the proguard file before it was created.  If you upload a
-                                 file with a forced UUID you can only upload a single proguard file.
   -h, --help                     Print help
 
 ```