- 3 minutes to read

Formula - concat

Easily merge string values using the Nodinite concat Formula plugin. This page shows how to combine strings from message Content, Context, or the output of other formulas.

🎯 Designed for business users and integrators — no developer required; you can even use AI to craft expressions.

  • ✅ Merge data from any Payload or Context in any Log Event
  • ✅ Combine multiple string values into a single result
  • ✅ Transform and surface meaningful data in Nodinite Log Views, search filters, and self-service diagnostics
  • ✅ Combine with other Formula functions for powerful, layered expressions

What does the concat Formula do?

The concat(Content1, Content2, ...) Formula function merges two or more string values into a single result. Use it with static text, message bodies, context values, or the results from other Formula functions to create combined data in your views.


How it works: Input ➜ concat ➜ Result

graph LR A["Input: Multiple strings/values"] --> B["concat(Content1, Content2, ...)"] B --> C["Result: Combined string"]

Flow: Multiple input values are concatenated into a single output string.


Syntax

Concatenate static strings: (See Example 1)

concat('String1', 'String2')

Concatenate with message body: (See Example 2)

concat(body, 'String')

Concatenate with message context: (See Example 4)

concat('String', context('MessageContextKey'))

Concatenate with nested formula: (See Example 5)

concat(jsonpath('$.path', body), 'String')

Common patterns:

concat(body, ' - ', context('id'))          # Body + separator + context
concat('Prefix: ', body)                     # Add prefix to body
concat(body, body)                           # Duplicate content

Examples

Example 1: Concatenate static strings

Input:

No input required (static values only)

Formula Expression:

concat('Formula', 'Plugin')

Result:

FormulaPlugin

standaloneParameters
Example: Concatenating static strings results in 'FormulaPlugin'.


Example 2: Concatenate message body with static string

Input:

Message body is Nod

Formula Expression:

concat(body, 'inite')

Result:

Nodinite

firstParameterFromBody
Example: Message body 'Nod' concatenated with 'inite' results in 'Nodinite'.


Example 3: Concatenate body with itself

Input:

Message body is Nod

Formula Expression:

concat(body, body)

Result:

NodNod

body as Parameter
Example: Body 'Nod' concatenated with itself results in 'NodNod'.


Example 4: Concatenate static value with context value

Input:

Message context contains a property id with value ination

Formula Expression:

concat('Imag', context('id'))

Result:

Imagination

contextAsContent
Example: Static text 'Imag' concatenated with context value 'ination' results in 'Imagination'.


Example 5: Use a formula function as a parameter

Input:

Message context contains a property id with value:

{ "Id": 2 }

Formula Expression:

concat(jsonpath('Id', context('id')), 'A')

Result:

2A

functionAsContextParameter
Example: Using jsonpath to extract 'Id' (value 2) and concatenating with 'A' results in '2A'.


Example 6: Advanced nested functions

Input:

Message body is gmt

Message context contains a property id with value utc

Formula Expression:

concat(touppercase(regex('gmt|utc', body)), touppercase(substring(0, 3, context('id'))))

Result:

GMTUTC

Nested Functions As Parameters
Example: Advanced nested functions using regex, touppercase, and substring to create 'GMTUTC'.

Message Context
Example: Message context property 'id' with value 'utc' used in nested function concatenation.


Features

Important

The concat Formula merges two or more string values into a single result. This function loads the entire message into RAM—use on small messages only.

  • Flexible Inputs: Merge from static text, message body, Context, or the result of another Formula
  • Multiple Values: Combine 2 or more strings in a single expression
  • Composable: Chain with other Formula functions like touppercase(), jsonpath(), substring()
  • Self-Service: Let business users build combined fields without developer intervention

How to use

To use the concat Formula in a Search Field Expression:

  1. Open your Nodinite Web Client
  2. Navigate to AdministrationSearch Fields
  3. Create or edit a Search Field
  4. Choose Formula as the expression type
  5. Enter your concatenation expression using the Syntax patterns above

Next step