diff --git a/.changeset/techdocs-angry-poems-doubt.md b/.changeset/techdocs-angry-poems-doubt.md
index 8dd1ffb88f..ba763a031c 100644
--- a/.changeset/techdocs-angry-poems-doubt.md
+++ b/.changeset/techdocs-angry-poems-doubt.md
@@ -1,5 +1,14 @@
 ---
-'@backstage/plugin-techdocs': patch
+'@backstage/plugin-techdocs': minor
 ---
 
 Adds support for being able to customize and compose your TechDocs reader page in the App.
+
+You can likely upgrade to this version without issue. If, however, you have
+imported the `<Reader />` component in your custom code, the name of a property
+has changed. You will need to make the following change anywhere you use it:
+
+```diff
+-<Reader entityId={value} />
++<Reader entityRef={value} />
+```