diff --git a/plugins/scaffolder/src/types.ts b/plugins/scaffolder/src/types.ts
index f96d103796..233e1192e9 100644
--- a/plugins/scaffolder/src/types.ts
+++ b/plugins/scaffolder/src/types.ts
@@ -73,6 +73,7 @@ type OutputLink = {
 
 export type TaskOutput = {
   entityRef?: string;
+  /** @deprecated use the `links` property to link out to relevant resources */
   remoteUrl?: string;
   links?: OutputLink[];
   [key: string]: any;