docs: Small note to custom scripts page (#6992)

Co-authored-by: caitlinwheeless <[email protected]>
HumanSignal · Jan 31, 2025 · fe6d0c4 · fe6d0c4
1 parent 17499d4
commit fe6d0c4
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/docs/source/guide/scripts.md b/docs/source/guide/scripts.md
@@ -118,6 +118,9 @@ Subscription to listen to events related to the Label Studio Frontend. Handlers
 
 For a list of all available events, see our [Frontend reference](frontend_reference#Available-events).
 
+!!! note
+    Top-level events such as `labelStudioLoad` and `storageInitialized` cannot be used with custom scripts, as they execute before the script is initialized.
+
 | Parameter &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; | Type     | Description          |
 |--------------------------|--------------------|--------------------------|
 | `eventName` | string | A case-sensitive string representing the event type to listen for.                  |