Intro

A message toast (sap.m.MessageToast) is a small, non-disruptive popup for success messages that disappears automatically after a few seconds.

Usage

Use the message toast if:

You want to display a short success message.
You do not want to interrupt users while they are performing an action.
You want to confirm a successful action.

Do not use the message toast if:

You want to display an error or warning message.
You want to interrupt users while they are performing an action.
You want to make sure that users read the message before they leave the page.
You want users to be able to copy the message content to the clipboard (such as a product or transaction number). In this case, use a success message dialog instead.

Responsiveness

The message toast has the same behavior on all devices.

Layout

Position

The message toast is always centered horizontally at the bottom of the screen.

Message toast on a desktop

Message toast on a desktop

Width

The standard width of the toast is 15 rem, and text that exceeds this width will wrap.

Behavior and Interaction

Choreography

When an action is successful, the message toast fades in and out automatically. The timing and duration of the message toast is defined by the application team.

Users can also keep the message toast on screen with the following keyboard shortcuts:

Ctrl + Shift + M (Windows)
Cmd + Shift + M (Mac OS)

In some scenarios, the action that triggers the message toast also triggers navigation to a different page (for example, after a save or submit action).

In this case, always navigate first, and then show the message toast on the target page.

Only show the message toast on the same page if no navigation is involved.

Exception: success message dialog

If you need to interrupt users before they leave the current page, do not use the message toast, but a message box (sap.m.MessageBox, property: type – success), which includes a success message. For more information, see message box.

information

Only put a success message in a message box if your use case requires explicit user interaction, such as copying an order number to process it. We strongly recommend using a message toast where possible.

Animation

Set the duration of the animation according to the length of the message text: the longer the text, the longer the duration should be. The message does not react to the user’s focus.

Guidelines

Message Toast Texts

To make the toast message easy to scan, keep the text as short as possible. Remember that the user will not have time to take in very much detail.

Do not use the word “successfully” in the message text. This is implicit in a success message.

Patterns

For standard actions (such as create, save, delete, or send), we recommend using the following patterns, depending on your use case.

<div> <div>Use Case</div> <div>Use Case Variant</div> <div>Pattern (EN)</div> <div>Example (EN)</div> </div> <div> <div>Single item</div> <div> <p>Object name is not needed.</p> <p>Hint: If the name or ID is not crucial feedback in your context, leave it out.</p> </div> <div>[object] [action taken]</div> <div><em>Sales order created</em></div> </div> <div> <div></div> <div> <p>Object name is needed.</p> <p>Hint: If you mention the object name, you can often leave out the object type (usually obvious in the context).</p> </div> <div>[name] [action taken]</div> <div><em>SAP added to customer group</em></div> </div> <div> <div>Multiple items</div> <div></div> <div>[item count] [objects] [action taken]</div> <div><em>2 sales orders were deleted.</em></div> </div> <div> <div>Multiple actions</div> <div>Single items, object names are not needed</div> <div>1 [object] [1st action taken], 1 [object] [2nd action taken]</div> <div><em>1 product added, 1 product removed</em></div> </div> <div> <div></div> <div> <p>Single items, object names are needed.</p> <p>Hint: Only include object names if the user really needs the specific feedback.</p> </div> <div>[object] [name] [1st action taken], [object] [name] [2nd action taken]</div> <div><em>Product A was added, product B was removed.</em></div> </div> <div> <div></div> <div>Multiple items</div> <div>[item count] [objects] [1st action taken], [item count] [objects] [2nd action taken]</div> <div><em>2 products added, 3 products removed</em></div> </div>

The exact phrasing will depend on your target audience and the conventions in your app family. If an action is repeated regularly by a heavy users, be as brief as possible (for example, Order deleted). If your app is typically for occasional users, a full sentence might be more appropriate (for example, Your request has been sent to the support team.).
Bear in mind that long object names can increase the length of the message toast. Remember to allow for this when defining the toast duration. If long or multiple object names make the toast too cumbersome to read, leave them out. If you really need to list them in a success message, use the success message box instead.
[internal_only]Only use periods for complete sentences. See UI Text Guidelines for SAP Fiori – Punctuation – Period.[/internal_only]

Toast without ID