diff --git a/.changeset/loud-singers-happen.md b/.changeset/loud-singers-happen.md
index 32dbdb8481..04207d6428 100644
--- a/.changeset/loud-singers-happen.md
+++ b/.changeset/loud-singers-happen.md
@@ -3,3 +3,14 @@
 ---
 
 Add the `relations` array to allow Backstage to mirror GitLab's membership behavior, including descendant, inherited, and shared-from-group memberships.
+
+The previous `allowInherited` config option will be deprecated in future versions. Use the `relations` array with the `INHERITED` option instead.
+
+```yaml
+catalog:
+  providers:
+    gitlab:
+      development:
+        relations:
+          - INHERITED
+```