Display Toast Message And Continue Execution

Audience: Low-code Engineers

Skill Prerequisites: Actions, HTML, Tokens

Shows a short notification, called a toast, in a small popup, then carries on with the next actions. It's available in forms and listings.

The toast only takes the space it needs. The rest of the page stays visible and usable, and the toast closes by itself after a set time.

Action	What happens after the toast
Display Toast Message And Stop Execution	No further actions run.
Display Toast Message And Continue Execution	The toast is shown right away and the next actions keep running.

Typical Use Cases

• Tell the user that a long-running step has started, such as a large import or report
• Show progress between steps, for example Order saved. Sending confirmation email...
• Confirm something to the user and still run the rest of the actions

Don't use it to

• Show a message and stop. Use Display Toast Message And Stop Execution instead.
• Show a long or important message the user shouldn't miss. Use Display Message or Display Error Message instead.
• Debug. Use Log Debug Message or Log Error instead.
• Report the result of the actions that come after it. They haven't run yet when the toast is shown.

Related Actions

Action Name	Description
Display Toast Message And Stop Execution	Shows the same toast and ends execution.
Display Message	Shows a message in place of the form and ends execution.
Display Error Message	Shows an error message and ends execution.
Execute Javascript Code And Continue Execution	Runs your own JavaScript in the browser and continues, for notifications the toast can't do.
Stop Execution	Stops running actions without a message.

Input Parameter Reference

Parameter	Description	Supports Tokens	Default	Required
Heading	An optional heading, shown in bold above the message.	Yes	empty string	No
Message	The text of the toast. It's a rich text editor, so you can use HTML.	Yes	empty string	No
Type	The style of the toast: Default, Warning, Success, Error or Info. Default is dark gray with no icon. The others have their own color and an icon on the left.	No	Default	No
Background Color	Overrides the background color of the type, for example red, #ff0000 or rgb(255,0,0). Leave it empty to use the color of the type.	Yes	empty string	No
Transition	How the toast appears and disappears: Fade, Slide or Plain.	No	Fade	No
Allow Toast Close	Shows an × in the top-right corner, so the user can close the toast.	No	false	No
Javascript	JavaScript that runs in the browser after the toast disappears, whether it closed by itself or the user closed it.	Yes	empty string	No
Hide (with transition^) after (ms)	How long the toast stays on screen, in milliseconds. It then closes with the chosen transition. Must be a whole number. Anything else is treated as 1000.	Yes	1000	No
Stack Length	The most toasts shown at the same time. When a new toast would go over this number, the oldest ones are removed. 1 shows one toast at a time.	Yes	1	No
Toast Position	Where the toast appears: Bottom Left, Bottom Right, Bottom Center, Top Right, Top Left, Top Center or Middle Center.	No	Bottom Center	No
Text Alignment	How the text is aligned: Left, Right or Center.	No	Left	No
Show Loader	Shows a progress bar at the top of the toast that fills up until the toast closes.	No	false	No
Loader Color	The color of the progress bar, for example red, #ff0000 or rgb(255,0,0). Only shown when Show Loader is on. Leave it empty for green (#9EC600).	Yes	empty string	No

When the toast appears

The toast is sent to the browser as soon as the action runs, and the browser shows it right away. Meanwhile, the server keeps running the remaining actions. So the user sees the toast while the rest of the actions are still working.

Considerations

• Stack several toasts. When Stack Length is 1, each new toast replaces the previous one. To show a series of progress messages together, set Stack Length to a higher number.
• Later actions can remove it. A redirect or a page refresh after this action removes the toast along with the page.
• HTML isn't encoded. The Heading and Message are shown as HTML, including token values. If a token holds text typed by a user, it's shown as HTML too.
• There's no "stay open" setting. The toast always closes after Hide (with transition^) after (ms). For a message the user must read, use a long time with Allow Toast Close, or use Display Message.
• The time includes the transition. A fade or slide takes about 400 ms of the display time. Very short times, such as 500, barely show the toast.
• Check the Javascript code. Tokens are placed in the code as plain text. A syntax error in the code stops the toast from showing. If the code fails when it runs, the error only appears in the browser console. Either way, the next actions still run.
• Empty values fall back. If a token or expression makes Stack Length empty or not a number, up to 5 toasts are shown. If Toast Position is empty, the toast appears at the bottom right.
• Conditions. To show the toast only in some cases, give it a condition, for example "[Status]" == "Saved". See Common Parameters.

Examples

tip

To understand how to use the below examples, please see Running Examples.

1. Tell the user a report is being built

This action shows an info toast at the top right for 10 seconds, with a progress bar. The actions after it, such as a slow SQL query, keep running on the server.

{
    "Title": "Display Toast Message And Continue Execution",
    "ActionType": "ShowToastAndContinue",
    "Description": "Tell the user the report is being built",
    "Parameters": {
        "Heading": "Building your report",
        "Message": "<p>This can take a minute, [User:FirstName]. Please don't close the page.</p>",
        "Icon": {
            "Expression": "",
            "Value": "info",
            "IsExpression": false,
            "Parameters": {}
        },
        "BgColor": "",
        "Transition": {
            "Expression": "",
            "Value": "fade",
            "IsExpression": false,
            "Parameters": {}
        },
        "AllowToastClose": true,
        "CallBackJsCode": "",
        "HideTime": "10000",
        "Stack": "3",
        "ToastPosition": {
            "Expression": "",
            "Value": "top-right",
            "IsExpression": false,
            "Parameters": {}
        },
        "TextAlignment": {
            "Expression": "",
            "Value": "left",
            "IsExpression": false,
            "Parameters": {}
        },
        "ShowLoader": true,
        "LoaderColor": "#ffffff"
    }
}

2. Confirm a paid order and keep going

This action shows a success toast with the order number when the Status token is Paid. The next actions, such as sending the confirmation email, still run.

{
    "Title": "Display Toast Message And Continue Execution",
    "ActionType": "ShowToastAndContinue",
    "Description": "Confirm the paid order",
    "Condition": "\"[Status]\" == \"Paid\"",
    "Parameters": {
        "Heading": "Order [OrderId] confirmed",
        "Message": "<p>We're sending a confirmation email now.</p>",
        "Icon": {
            "Expression": "",
            "Value": "success",
            "IsExpression": false,
            "Parameters": {}
        },
        "Transition": {
            "Expression": "",
            "Value": "slide",
            "IsExpression": false,
            "Parameters": {}
        },
        "AllowToastClose": false,
        "HideTime": "4000",
        "Stack": "1",
        "ToastPosition": {
            "Expression": "",
            "Value": "bottom-center",
            "IsExpression": false,
            "Parameters": {}
        },
        "TextAlignment": {
            "Expression": "",
            "Value": "left",
            "IsExpression": false,
            "Parameters": {}
        },
        "ShowLoader": false
    }
}

Revised 09/27/2026