LogoObsidian

Notifications

Timed and persistent toast notifications for non-blocking feedback.


Notifications

notification

Use Library:Notify() for quick, non-blocking feedback. Notifications support:

  • Simple timed popups.
  • Persistent messages you can update or destroy.
  • Progress indicators with step counters.
  • Optional sounds or other custom behavior based on your own logic.

Creating a notification

Choose between positional arguments for quick calls or a configuration table for full control.

Regular parameters

Library:Notify("Hello world!", 4)
Arg IdxArgument DescriptionTypeDefault
1Description of the notificationstring"nil"
2Amount of time to show the notification fornumber | instance4
3SoundId to play when the notification is shownnumbernil

Table parameters

Pick an example that matches your use case:

Library:Notify({
    Title = "mspaint",
    Description = "Hello world!",
    Time = 4,
})

Prop

Type

Methods

ChangeTitle

Update the notification title without recreating it.

Notification:ChangeTitle("New Title")
Arg IdxArgument DescriptionTypeDefault
1New title of the notificationstringnil

ChangeDescription

Refresh the supporting text while keeping the notification open.

Notification:ChangeDescription("New Description")
Arg IdxArgument DescriptionTypeDefault
1New description of the notificationstringnil

ChangeStep

Advance or rewind the progress bar when using step-based notifications.

Notification:ChangeStep(5)
Arg IdxArgument DescriptionTypeDefault
1New step of the progress notificationnumbernil

Destroy

Immediately dismiss the notification and free its resources.

Notification:Destroy()

On this page