diff --git a/.changeset/green-trees-wait.md b/.changeset/green-trees-wait.md
index f5079db7c7..388298ef59 100644
--- a/.changeset/green-trees-wait.md
+++ b/.changeset/green-trees-wait.md
@@ -2,4 +2,21 @@
 '@backstage/create-app': patch
 ---
 
-imports `useSearch` hook from new `@backstage/plugin-search-react` package
+imports `useSearch` hook from new `@backstage/plugin-search-react` package.
+
+To upgrade existing Apps:
+
+1. Change the import to the following:
+
+`packages/app/src/components/search/SearchPage.tsx`
+
+```diff
+import {
+...
+SearchType,
+- useSearch,
+} from '@backstage/plugin-search';
++import { useSearch } from '@backstage/plugin-search-react';
+```
+
+2. Add `@backstage/plugin-search-react` as a dependency to the app.