diff --git a/cmd/convert/convert.go b/cmd/convert/convert.go
index dd95cec3..757e547f 100644
--- a/cmd/convert/convert.go
+++ b/cmd/convert/convert.go
@@ -39,8 +39,9 @@ func NewConvertOptions(streams genericclioptions.IOStreams) *cobra.Command {
 	}
 
 	cmd := &cobra.Command{
-		Use:   "convert",
-		Short: "Convert a deprecated resource to its replacement",
+		Use:        "convert",
+		Short:      "Convert a deprecated resource to its replacement",
+		Deprecated: "it has been replaced by the crane-plugin-buildconfig-to-shipwright plugin (https://github.com/migtools/crane-plugin-buildconfig-to-shipwright). Use it via `crane transform` instead.",
 		RunE: func(c *cobra.Command, args []string) error {
 			if err := t.Complete(c, args); err != nil {
 				return err