Configuring error alerts

Configure a user-friendly message of the error to be sent to users, for example, "It looks like our system is unavailable."

Alert configuration properties

Properties	Description
actions	Interactive buttons or controls displayed within the alert let users respond or take specific actions. Use IntelliSense to see the list of available actions.
title	The main heading text is displayed at the top of the alert.
description	The detailed message content that explains the alert’s purpose, provides instructions, or delivers additional information to the user.
dismiss	Configures how users can dismiss the alert. You can enable a gesture dismissal and set an automatic dismissal time. autoAfter - specify the number of seconds after which the alert is automatically dismissed. Has no effect when dismiss is disabled. isEnabled - When set to true (default), allowing manual dismissal by swiping down. When set to false, the alert cannot be dismissed manually.
icon	The icon displayed alongside the alert content provides visual context and helps users recognize the alert’s type or purpose. The alert’s style property determines the icon color. If no style is set, the default isWarning style is applied.
group	Grouping allows you to manage multiple alerts under a shared identifier. This ensures that only one alert from a group is visible at a time, preventing alert overload and improving the user experience.
group	id - Identifier for the alert group. Only one alert per group can be visible at a time. If a new alert with the same group ID is triggered while another is active, it will be skipped. Use groupId to manage multiple alerts for the same issue. When using modal presentation, alerts with the same groupId are grouped so that only the first alert appears and subsequent ones are automatically skipped. When using toast presentation, alerts are also grouped, preventing duplicates. Users can tap the toast to view details — if multiple alerts exist, they stack and display a count at the top. Swiping left lets users view each alert’s details within the stack.
group	presentAs: Specifies how the alert is presented to the user. Options include: toast (default): For brief, lightweight notifications. modal: For important messages that require attention and may include additional information. Modal alerts are more disruptive since they block the UI and are typically used for critical information.
style	Visual styling options let you set the tone of the alert: isPositive (success/confirmation) isNegative (error) styling to convey the appropriate tone and urgency. isWarning (warning) styling is used by default.
subtitle	Secondary text that appears below the title, providing additional context or supplementary information.

Alert presentation types

When an error occurs, Jigx can present alerts to users in two ways:

• As a toast

• As a modal

Choosing the right presentation type depends on the severity of the error and how disruptive you need the notification to be.

Automatic vs custom error grouping

Automatic error grouping

Errors are automatically grouped by default to prevent alert overload, unless a custom error handler is explicitly configured.

• Errors are auto-grouped using the following key:

{solutionId}/{hostUrl}/{errorCode}

• If the hostUrl cannot be resolved, grouping falls back to:

{functionId}

• When multiple functions encounter the same error on the same host, only one alert is shown, the first failure triggers the alert.

• Custom error handlers that specify a different groupId are not auto-grouped and will display as separate alerts.

• To reduce user frustration in edge cases where not all errors are grouped, the Close All option is available. You can further refine grouping behavior by explicitly defining groupId values in your error handler configuration.

Custom error grouping

You can explicitly control how errors and alerts are grouped by assigning a groupId. Grouping ensures that only one alert per group is shown at a time, helping to reduce duplicate or repetitive messages.

When an alert is triggered with a groupId that matches an active alert, subsequent alerts in the same group are skipped.

• Modal alerts: Alerts with the same groupId are grouped so that only the first alert is displayed.

• Toast alerts: Alerts are grouped to prevent duplicates. If multiple alerts exist, they stack and display a count indicator. Users can tap the toast to view details and swipe left to navigate between alerts in the stack.

Use custom error grouping when you want precise control over how related errors are presented to users, especially when handling recurring or function-specific failures.

Examples and code snippets

 alert:
      title: System Offline
      description: 
        It looks like our system is temporarily unavailable.
        Please try again in a little while. Thank you for your patience!
      icon: server-error-403-hand-forbidden
      style:
        isNegative: true
      # Presentation style (overlays the current screen), can be modal or toast.   
      presentAs: toast
      # Grouping allows you to manage multiple alerts under a shared identifier. 
      # This ensures that only one alert from a group of errors is visible.
      group:
        id: code403
    # Configure information to be logged in the datasync-error table.  
    title: System Offline
    description: System is temporarily unavailable.
    details: =@ctx.response.body