From 0ed2e9d82dafec8aade30502c44cb45871b54fec Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20Bosi?=
 <71827178+bosiraphael@users.noreply.github.com>
Date: Fri, 29 May 2026 17:59:14 +0200
Subject: [PATCH] Docs: clarify numberOfSelectedRecords usage for
 RECORD_SELECTION items (#21059)

Add a note to the command menu items docs explaining that
RECORD_SELECTION already guarantees a non-empty selection, so
numberOfSelectedRecords > 0 is redundant in
conditionalAvailabilityExpression.
---
 .../developers/extend/apps/layout/command-menu-items.mdx      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/twenty-docs/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/developers/extend/apps/layout/command-menu-items.mdx
index 91f258cb2f9..35078122d67 100644
--- a/packages/twenty-docs/developers/extend/apps/layout/command-menu-items.mdx
+++ b/packages/twenty-docs/developers/extend/apps/layout/command-menu-items.mdx
@@ -103,6 +103,10 @@ export default defineCommandMenuItem({
 });
 ```
 
+<Note>
+  `RECORD_SELECTION` already implies a non-empty selection — use `numberOfSelectedRecords` only for specific counts (e.g. `>= 2`).
+</Note>
+
 ### Context variables
 
 These represent the current state of the page: