diff --git a/docs/HyperIndex/Guides/configuration-file.mdx b/docs/HyperIndex/Guides/configuration-file.mdx
index 911f8cc6..6703cac0 100644
--- a/docs/HyperIndex/Guides/configuration-file.mdx
+++ b/docs/HyperIndex/Guides/configuration-file.mdx
@@ -95,6 +95,12 @@ events:
   - event: "ClearGreeting(address user)"
 ```
 
+:::important
+Choose **one** event definition style. Use either names from an ABI file *or*
+human‑readable event signatures. Mixing both in the same contract isn’t
+supported and can cause errors.
+:::
+
 By default, all events defined in the contract are indexed, but you can selectively disable them by removing them from this list.
 
 #### Custom Event Names
diff --git a/static/schemas/config.evm.json b/static/schemas/config.evm.json
index daf4731a..5697e836 100644
--- a/static/schemas/config.evm.json
+++ b/static/schemas/config.evm.json
@@ -150,7 +150,7 @@
       "type": "object",
       "properties": {
         "event": {
-          "description": "The human readable signature of an event 'eg. Transfer(address indexed from, address indexed to, uint256 value)' OR a reference to the name of an event in a json ABI file defined in your contract config. A provided signature will take precedence over what is defined in the json ABI",
+          "description": "The human readable signature of an event 'eg. Transfer(address indexed from, address indexed to, uint256 value)' OR a reference to the name of an event in a json ABI file defined in your contract config. A provided signature will take precedence over what is defined in the json ABI. Use either signatures or ABI event names consistently - do not mix both styles.",
           "type": "string"
         },
         "name": {