Show notification

The Show Notification task allows you to display messages to the user during a workflow or event. Notifications are a simple yet powerful way to provide feedback, confirmations, warnings, or error messages in response to user actions or system events.

Purpose

• Display success, error, or informational messages.
• Guide users during multi-step workflows.
• Notify users about completed actions or validation results.
• Provide contextual alerts without navigating away.

Anatomy

1. Step name
   • Name of the task in the event flow.
   • Example: Show notification.
2. Message
   • The actual text or dynamic expression to display in the notification.
   • Supports plain text or bindings (e.g., {{ query1.errorMessage }}).
   • Example: Hello world
3. Variant
   • Defines the style/intent of the notification.
   • Common options:
     • Default → neutral message
     • Success → green highlight, indicates completed action
     • Error → red highlight, indicates failure
     • Warning → yellow/orange, indicates caution
     • Info → blue, informational context
4. Anchor origin
   • Defines the position of the notification on the screen.
   • Vertical: Top or Bottom
   • Horizontal: Left, Center, Right
   • Example: Bottom-Center (default Snackbar style).

How It Works

1. When the Show Notification task is executed in a flow, it displays a temporary pop-up message on the UI.
2. Users can read the notification and continue their work.
3. Multiple notifications can be displayed sequentially, depending on event triggers.

Example 1: Success Notification

• Message: Customer record saved successfully.
• Variant: Success
• Anchor origin: Bottom-Center

Usage: After a query is executed successfully.

Example 2: Error Notification with Dynamic Data

• Message: Failed to save record: {{ query1.errorMessage }}
• Variant: Error
• Anchor origin: Top-Right

Usage: Triggered if query execution fails.

Example 3: Informational Notification

• Message: Your session will expire in 5 minutes.
• Variant: Info
• Anchor origin: Top-Center

Usage: For proactive system messages.

Best Practices

• Keep messages short and clear → concise text is easier to read in notifications.
• Use variants consistently → success for completed actions, error for failures, info/warning for alerts.
• Choose placement wisely → top positions for critical alerts, bottom positions for passive confirmations.
• Leverage dynamic bindings → show error codes, usernames, or other contextual data using {{ bindings }}.
• Don’t overload users → too many notifications in a short time can cause alert fatigue.

FAQ

Q: Can notifications be permanent?

• No. Notifications are designed to auto-dismiss after a short duration. For permanent alerts, use dedicated UI components (like banners).

Q: Can I include HTML or rich text in messages?

• Typically plain text is recommended, but bindings and dynamic text are supported.

Q: Can I trigger multiple notifications in sequence?

• Yes, by placing multiple Show Notification tasks in an event flow.

👉 In summary: Show Notification provides immediate, contextual feedback to users. With configurable variants and positions, you can tailor messages for success, error, info, or warnings to create a more user-friendly and guided experience in Zeroplat.