Skip to main content

Conditions

Conditions are used to evaluate logical conditions within the Flow platform. It supports a wide range of comparison types and is commonly used in rules, logic flows, widgets, and automations.

Purpose​

This helper allows you to define conditions using simple syntax and run logic only when those conditions are true.

Where Conditionals Are Used​

Conditionals are widely used across the Flow platform to control visibility and behavior dynamically:

  • Forms

    • Visibility: Show or hide a form based on specific conditions (e.g., user role, item status).
    • Triggers: Execute logic (e.g., autofill, CRUD operations) when certain conditions are met.

  • ActionButtons

    • Visibility: Show or hide buttons depending on user context, field values, or item state.

These conditionals are defined using the same JSON format and evaluated by the ConditionalHelper.

JSON Structure​

A typical conditional block looks like this:

{
  "if": [
    [
      "field_name",
      "is",
      "empty"
    ]
  ],
  "then": {
    "doSomething": true
  },
  "breakAfter": false
}
  • "if": An array of condition arrays. Each condition is structured as [leftOperand, condition, rightOperand].
  • "then": The action(s) to perform if the condition(s) are true.
  • "breakAfter": (Optional) Whether to stop processing further rules if this one is matched.

Supported Conditions​

JSON Condition KeywordDescriptionExample
"is" or "="Equals["status", "is", "done"]
"!=" or "<>"Not equal["type", "!=", "archived"]
">"Greater than["age", ">", 18]
">="Greater or equal["score", ">=", 10]
"<"Less than["quantity", "<", 5]
"<="Less or equal["price", "<=", 100]
"contains"String contains["description", "contains", "urgent"]
"notcontains"String does not contain["title", "notcontains", "test"]
"startswith"String starts with["filename", "startswith", "img_"]
"endswith"String ends with["filename", "endswith", ".jpg"]
"in"Value is in list["color", "in", "red,green,blue"]
"notin"Value is not in list["status", "notin", "cancelled,draft"]
"empty"Value is empty or null["comment", "is", "empty"]
"notempty"Value is not empty["name", "is", "notempty"]

JSON Usage Examples​

Example: Check if a list is empty, then clear a field on each item​

{
  "if": [
    [
      "optaelling_liste",
      "is",
      "empty"
    ]
  ],
  "then": {
    "loop": "produkter",
    "crud": {
      "update": {
        "[loopvalue]": {
          "customfield": {
            "cf1434": ""
          }
        }
      }
    }
  },
  "breakAfter": false
}

Example: Only show button if user is in group “admin”​

{
  "if": [
    [
      "[usergroups]",
      "contains",
      "admin"
    ]
  ],
  "then": {
    "visible": true
  }
}

Example: Make a form visible only when the status is not "closed"​

{
  "if": [
    [
      "[item.cf1001]",
      "!=",
      "closed"
    ]
  ],
  "then": {
    "visible": true
  }
}

Notes​

  • Most values can be dynamic, using Replaceables like [user], [item.cf1234], etc.
  • String comparisons are case-insensitive by default.
  • Arrays and comma-separated values are supported for "in" and "contains".
  • For more info on how JSON queries work, see JSON Queries.