diff --git a/.changeset/violet-trees-play.md b/.changeset/violet-trees-play.md
index c56635633c..00f1e156a8 100644
--- a/.changeset/violet-trees-play.md
+++ b/.changeset/violet-trees-play.md
@@ -2,4 +2,13 @@
 '@backstage/plugin-shortcuts': minor
 ---
 
-Fixed shortcuts initialization when using firestore
+Internal observable replaced with a mapping from the storage API. This fixes shortcuts initialization when using firestore.
+
+`ShortcutApi.get` method, that returns an immediate snapshot of shortcuts, made public.
+
+Example of how to get and observe `shortcuts`:
+
+```typescript
+const shortcutApi = useApi(shortcutsApiRef);
+const shortcuts = useObservable(shortcutApi.shortcut$(), shortcutApi.get());
+```