Intro

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

Message toast component

When to Use

Do

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.

Don't

Don’t 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.

Вмъкване на изображение...

Use a message toast to display a short success message

Вмъкване на изображение...

Don’t use a message toast for error or warning messages

Anatomy

The message toast component consists of two parts:

  1. Text: The message displayed to the user.
  2. Container: The background frame that holds the message.

Message toast anatomy

Layout

Position

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

Вмъкване на изображение...

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 appears briefly and fades out automatically. Its display duration can be configured as needed.

Users can keep the message toast visible for longer if they need more time to read it (for example, if it contains more detailed information) by pressing Ctrl + Shift + M (Windows) or 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.

Responsiveness

The message toast has the same behavior on all devices.

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>
information

Notes on phrasing and readability

  • 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]

Do

Use simple messages like Product saved without technical identifiers, such as Product number 12345 saved.

Don't

Вмъкване на изображение...

Do not use redundant words like "successfully" as the confirmation message already implies that.

Do

Toast with item count

Don't

Вмъкване на изображение...

Do not list names of multiple items.

SAP Fiori Elements

If you are using SAP Fiori elements, remember to replace the “object” placeholder with your business object.

For more information, see SAP Fiori Elements – Mandatory Adjustments.

Do

Use a specific business term like "Purchase order deleted”.

Don't

Do not use generic placeholders like "object deleted".

Properties

You can change the values of the following properties. Only change the values if the standard values don’t work for your use case.

Position: We recommend that you always use the initial value (horizontally centered, at the bottom of the page).

Duration: The standard value is 3,000 ms. You can set a duration of more than 3,000 ms, but do not use less than 3,000 ms.

Offset: Do not change this value.

Auto-close: The message toast appears momentarily and then fades out automatically when auto-close is enabled (set to true), which is the common setup. If auto-close is disabled (set to false), the message toast remains visible until manually dismissed.

A message toast displayed briefly on screen before it fades out or is manually dismissed.

Elements and Controls

Implementation

Visual Design

Elements and Controls

Implementation