Behavior & Accessibility

Dismiss Rules

3 min read

Dismiss rules control how and when a notification goes away. Some settings live on the Behavior tab, and others on the Timing tab under Display Duration.

Open your notification in the editor. See Notification Editor Tabs Overview if you need help finding these tabs.

Manual close (close button)

For visitors to close the notification themselves, your template needs a close control.

BuilderHow to add a close button
HTML BuilderAdd an element with class notifal-close-button
Block EditorUse the Close Icon block
ElementorUse the Notifal Close Icon widget

See HTML Builder: Buttons, Close Icon, and Click Tracking for examples.

On the Timing tab, choose Display Duration → Manual Close Only if you want the notification to stay until the visitor closes it.

Important: If you pick Manual Close Only but your template has no close button, visitors may have no way to dismiss it (unless you enable Pro dismiss options like clicking outside).

Auto-dismiss timer

To hide the notification after a set time, use the Timing tab → Display Duration:

OptionWhat happens
Auto-Hide OnlyDisappears after X seconds. No manual close needed.
Auto-Hide + Manual CloseStays up to X seconds, but the visitor can close it sooner with a close button. Set 0 seconds for "forever until manually dismissed."

Set the number of seconds in Auto Hide Duration or Persistent Duration depending on the option you chose.

This is separate from Show Timing (when the notification first appears). See When Should the Notification Show?.

Remember when someone closed it

On the Timing tab under Frequency Control:

SettingWhat it does
Respect User DismissalAfter a manual close, do not show the same notification again during that browser session.
Maintain State on Refresh (Behavior tab)Remember dismissed/active state even if the visitor refreshes the page.

Pair with Frequency and Session Limits to avoid showing the same message too often.

Close after actions inside the notification

On the Behavior tab under Advanced Behavior:

SettingWhat it does
Close on Form SubmitCloses after a form inside the notification is submitted (with optional delay so success text is visible).
Close on Action Button ClickCloses after a template action button is clicked (Shop now, Copy, Add to Cart, etc.).

Quick setup examples

Social proof toast that fades away: Timing → Auto-Hide Only → 8 seconds. No close button required.

Important offer popup: Template with close button + Timing → Auto-Hide + Manual Close → 60 seconds.

One-time welcome message: Respect User Dismissal ON + Show Frequency → Per Session.

In this topic

  1. Dismiss Rules (you are here)
  2. User Interaction Dismiss Options (Pro)
  3. Accessibility: Focus Trap and ARIA
  4. Tab Badge Behavior (Pro)