UX - Message
Type identifier:
ux:messageCategory: 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 |
|---|---|---|
| control | Triggers the message display. |
| varies | Dynamic handles for message template variables. |
Output Handles
Handle | Data Type | Description |
|---|---|---|
| control | Triggered after the message is sent. |
Configuration Options
Option | Type | Default | Description |
|---|---|---|---|
Level |
|
| Message severity level. |
Delivery Method |
|
| How the message is delivered. |
Message Template |
| - | The message content with optional variables. |
Variables |
| - | Variable names used in the template. |
Message Levels
Level | Use Case | Visual Style |
|---|---|---|
| Confirm successful actions | Green, checkmark icon |
| Informational notices | Blue, info icon |
| Caution messages | Yellow/Orange, warning icon |
| Error notifications | Red, error icon |
Behaviour
- Receives trigger from control flow
- Fills the template variables with the values from the input handles
- Shows the message to the user as a toast at the selected level
- Triggers
donecontrol 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: 3itemName: "widget"
Result: "Added 3 widget(s) to your cart."
Error Notification
Configuration:
- Level:
error - Message: "Failed to process your request. Please try again."