diff --git a/packages/backend-plugin-api/src/services/definitions/IdentityService.ts b/packages/backend-plugin-api/src/services/definitions/IdentityService.ts
index 5e18e26585..daa45b8200 100644
--- a/packages/backend-plugin-api/src/services/definitions/IdentityService.ts
+++ b/packages/backend-plugin-api/src/services/definitions/IdentityService.ts
@@ -22,6 +22,6 @@ import { IdentityApi } from '@backstage/plugin-auth-node';
  * See the {@link https://backstage.io/docs/backend-system/core-services/identity | service documentation} for more details.
  *
  * @public
- * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead.
+ * @deprecated Please {@link https://backstage.io/docs/tutorials/auth-service-migration | migrate} to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead.
  */
 export interface IdentityService extends IdentityApi {}