Edit

Notify function in Power Apps

  • Article
  • 2 minutes to read

Displays a banner message to the user.

Description

The Notify function displays a banner message to the user at the top of the screen. The notification will remain until the user dismisses it or the timeout expires which defaults to 10 seconds.

An appropriate color and icon are used depending on the type of the message. The type is specified by the second argument to the function:

Note

The character limit for Notify function is 500 characters.

NotificationType Argument Description
NotificationType.Error Displays the message as an error.
NotificationType.Information (Default) Displays the message as informational.
NotificationType.Success Displays the message as success.
NotificationType.Warning Displays the message as a warning.

Messages are shown both when authoring your app and when end users are using your app.

Notify can only be used in behavior formulas.

Notify can be paired with the IfError function to detect and report errors with a custom error message.

Power Apps can also send push notifications using an entirely different mechanism from Notify. For more information see Send a notification in Power Apps.

Notify always returns true.

Note: This function was previously named ShowError when it could only display error messages.

Syntax

Notify( Message [, NotificationType [ , Timeout ] ] )

  • Message – Required. Message to display to the user.
  • NotificationType – Optional. Type of the message to display from the table above. The default is NotificationType.Information.
  • Timeout – Optional. Number of milliseconds to wait before automatically dismissing the notification. The default is 10 seconds (or 10,000 milliseconds). The notification will be displayed indefinitely with a Timeout of 0.

Examples

Step by step

  1. Add a Button control to your screen.

  2. Set the OnSelect property of the Button to the formula:

    Notify( "Hello, World" )

  3. Click or press the button.

    Each time the button is clicked, the message Hello, World is displayed to the user as informational. It will dismiss automatically in 10 seconds (default timeout) if the user does not dismiss it or press the button again.

    In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a blue banner message for the user.

  4. Change the type of message to indicate an error. Add a second argument to our formula:

    Notify( "Hello, World", NotificationType.Error )

  5. Click or press the button.

    Now each time the button is clicked, the message Hello, World is displayed to the user as an error. It will dismiss automatically in 10 seconds (default timeout) if the user does not dismiss it or press the button again.

    In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a red banner message for the user.

  6. Change the type of message to indicate a warning. Change the second argument in our formula:

    Notify( "Hello, World", NotificationType.Warning, 4000 )

  7. Click or press the button.

    Now each time the button is clicked, the message Hello, World is displayed to the user as a warning. It will dismiss automatically in 4 seconds (4,000 milliseconds) if the user does not dismiss it or press the button again.

    In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as an orange banner message for the user.

  8. Change the type of message to indicate success. Change the second argument in our formula:

    Notify( "Hello, World", NotificationType.Success, 0 )

  9. Click or press the button.

    Now each time the button is clicked, the message Hello, World is displayed to the user as success. With a 0 timeout, the notification will only be dismissed by the user or by pressing the button again.

    In the authoring environment, showing Button.OnSelect calling Notify and displaying the resulting Hello, World message as a green banner message for the user.