diff --git a/resources/metadata/mavenBuild.yaml b/resources/metadata/mavenBuild.yaml
index 7e02f951f..616b7563a 100644
--- a/resources/metadata/mavenBuild.yaml
+++ b/resources/metadata/mavenBuild.yaml
@@ -235,6 +235,11 @@ spec:
       - name: deployFlags
         type: "[]string"
         description: maven deploy flags that will be used when publish is detected.
+        longDescription: |
+          Maven deploy flags that will be used when publish is detected.
+
+          `Build with optimized goals:`
+          By default, the deploy process skips the main, test, and install Maven goals to reduce build time and avoid redundant executions. If you provide custom deployFlags, manually add the default flags to maintain build optimization unless you override them.
         scope:
           - STEPS
           - STAGES