diff --git a/api/src/main/resources/schema/states/foreachstate.json b/api/src/main/resources/schema/states/foreachstate.json
index 2740d128..06c0807f 100644
--- a/api/src/main/resources/schema/states/foreachstate.json
+++ b/api/src/main/resources/schema/states/foreachstate.json
@@ -21,11 +21,11 @@
       "type": "string",
       "description": "Name of the iteration parameter that can be referenced in actions/workflow. For each parallel iteration, this param should contain an unique element of the inputCollection array"
     },
-    "max": {
+    "batchSize": {
       "type": "integer",
       "default": "0",
       "minimum": 0,
-      "description": "Specifies how upper bound on how many iterations may run in parallel"
+      "description": "Specifies how many iterations may run in parallel at the same time. Used if 'mode' property is set to 'parallel' (default)"
     },
     "actions": {
       "type": "array",
@@ -39,6 +39,15 @@
       "type": "boolean",
       "default": false,
       "description": "If true, this state is used to compensate another state. Default is false"
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "sequential",
+        "parallel"
+      ],
+      "description": "Specifies how iterations are to be performed (sequentially or in parallel)",
+      "default": "parallel"
     }
   },
   "oneOf": [