Ligantic
Knowledge Base
Tutorials
Updates
Search Articles
Login
Free Sign Up
Home
Get Started
Tutorials
How-to guides
Reference
Explanation
Spaces
Schemas
Flows
Experiences
Endpoints
SDK and CLI
Browse documentation
Home
Get Started
Spaces
Schemas
Flows
Experiences
Endpoints
SDK and CLI
Docs
/

UX - Message

Type identifier: ux:message Category: UX Operations

Description

The UX - Message node sends a notification message to users in an Experience. It supports different severity levels (success, info, warning, error) and can include dynamic content through variable interpolation. Messages are displayed as toast notifications in the user interface.

Input Handles

Handle

Data Type

Description

trigger

control

Triggers the message display.

{variable}

varies

Dynamic handles for message template variables.

Output Handles

Handle

Data Type

Description

done

control

Triggered after the message is sent.

Configuration Options

Option

Type

Default

Description

Level

"success" | "info" | "warning" | "error"

"info"

Message severity level.

Delivery Method

"toast"

"toast"

How the message is delivered.

Message Template

string or Content

-

The message content with optional variables.

Variables

string[]

-

Variable names used in the template.

Message Levels

Level

Use Case

Visual Style

success

Confirm successful actions

Green, checkmark icon

info

Informational notices

Blue, info icon

warning

Caution messages

Yellow/Orange, warning icon

error

Error notifications

Red, error icon

Behaviour

  1. Receives trigger from control flow
  2. Fills the template variables with the values from the input handles
  3. Shows the message to the user as a toast at the selected level
  4. Triggers done control flow

Variable Interpolation

Variables in the message template are replaced with actual values:

  • Reference variables using {variableName} syntax in templates
  • Variables can be strings, numbers, or complex objects
  • Content-type templates support rich formatting

Output Format

The node produces a ux:message output that Experiences render as toast notifications:

{
  "type": "ux:message",
  "level": "success",
  "deliveryMethod": "toast",
  "message": "Your order has been placed!"
}

Examples

Success Confirmation

Configuration:

  • Level: success
  • Message: "Your changes have been saved successfully."

Dynamic Message

Configuration:

  • Level: info
  • Variables: ["count", "itemName"]
  • Message: "Added {count} {itemName}(s) to your cart."

Inputs:

  • count: 3
  • itemName: "widget"

Result: "Added 3 widget(s) to your cart."

Error Notification

Configuration:

  • Level: error
  • Message: "Failed to process your request. Please try again."

Related pages

Flow - Trigger
Entry point for Flow runs. Defines the inputs that a Flow accepts and makes them available to downstream nodes. A Flow must have at least one trigger node; each run starts at the trigger node it selects. A Canvas Flow literal run is the exception: its definition must declare exactly one trigger node.
Page not found. It may have moved or may not be published.
Browse documentation