diff --git a/plugins/pagerduty/api-report.md b/plugins/pagerduty/api-report.md
index db73259dd5..a96cab1af1 100644
--- a/plugins/pagerduty/api-report.md
+++ b/plugins/pagerduty/api-report.md
@@ -16,7 +16,7 @@ import { JSX as JSX_2 } from 'react';
 import { default as React_2 } from 'react';
 import { ReactNode } from 'react';
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export const EntityPagerDutyCard: (
   props: EntityPagerDutyCardProps,
 ) => JSX_2.Element;
@@ -27,7 +27,7 @@ export type EntityPagerDutyCardProps = {
   disableChangeEvents?: boolean;
 };
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export const HomePagePagerDutyCard: (
   props: CardExtensionProps<HomePagePagerDutyCardProps>,
 ) => JSX_2.Element;
@@ -138,7 +138,7 @@ export type PagerDutyClientApiDependencies = {
   fetchApi: FetchApi;
 };
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export type PagerDutyEntity = {
   integrationKey?: string;
   serviceId?: string;
@@ -176,7 +176,7 @@ export type PagerDutyOnCallsResponse = {
   oncalls: PagerDutyOnCall[];
 };
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 const pagerDutyPlugin: BackstagePlugin<{}, {}>;
 export { pagerDutyPlugin };
 export { pagerDutyPlugin as plugin };
diff --git a/plugins/pagerduty/src/plugin.ts b/plugins/pagerduty/src/plugin.ts
index 22f8ae60ee..4144eb5878 100644
--- a/plugins/pagerduty/src/plugin.ts
+++ b/plugins/pagerduty/src/plugin.ts
@@ -32,7 +32,7 @@ export const rootRouteRef = createRouteRef({
 
 /**
  * @public
- * @deprecated This plugin will be removed in a future release. Please use @pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/@pagerduty/backstage-plugin).
+ * @deprecated This plugin will be removed in a future release. Please use \@pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/\@pagerduty/backstage-plugin).
  */
 export const pagerDutyPlugin = createPlugin({
   id: 'pagerduty',
@@ -52,7 +52,7 @@ export const pagerDutyPlugin = createPlugin({
 
 /**
  * @public
- * @deprecated This plugin and it's cards will be removed in a future release. Please use @pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/@pagerduty/backstage-plugin).
+ * @deprecated This plugin and it's cards will be removed in a future release. Please use \@pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/\@pagerduty/backstage-plugin).
  */
 export const EntityPagerDutyCard = pagerDutyPlugin.provide(
   createComponentExtension({
@@ -68,7 +68,7 @@ export const EntityPagerDutyCard = pagerDutyPlugin.provide(
 
 /**
  * @public
- * @deprecated This plugin and it's cards will be removed in a future release. Please use @pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/@pagerduty/backstage-plugin).
+ * @deprecated This plugin and it's cards will be removed in a future release. Please use \@pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/\@pagerduty/backstage-plugin).
  */
 export const HomePagePagerDutyCard = pagerDutyPlugin.provide(
   createCardExtension<HomePagePagerDutyCardProps>({
diff --git a/plugins/pagerduty/src/types.ts b/plugins/pagerduty/src/types.ts
index 3ecfb4e745..e026a6ffbe 100644
--- a/plugins/pagerduty/src/types.ts
+++ b/plugins/pagerduty/src/types.ts
@@ -16,7 +16,7 @@
 
 /**
  * @public
- * @deprecated This plugin and it's types will be removed in a future release. Please use @pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/@pagerduty/backstage-plugin).
+ * @deprecated This plugin and it's types will be removed in a future release. Please use \@pagerduty/backstage-plugin plugin instead (https://www.npmjs.com/package/\@pagerduty/backstage-plugin).
  */
 export type PagerDutyEntity = {
   integrationKey?: string;