From 28b86afef90156b26da3432ebe3941da14139193 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Tue, 1 Sep 2026 07:00:34 +0000 Subject: [PATCH 1/2] Document live preview in the web Notification editor Add an 'Editing a Notification' subsection to web_notifications.rst describing how the editor's preview panel updates as you type the Heading, Message, and Action Button Text fields, and how empty fields behave in the preview (mautic/mautic#16928). --- docs/channels/web_notifications.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/channels/web_notifications.rst b/docs/channels/web_notifications.rst index 76330cbf9..6a552de62 100644 --- a/docs/channels/web_notifications.rst +++ b/docs/channels/web_notifications.rst @@ -32,6 +32,12 @@ Configuration #. Get the keys from OneSignal under the Settings > Keys & IDs tab. #. Enable the features you wish to use - for example, whether to enable notifications on mobile apps, Landing Pages, tracked resources on your website, and whether to show a welcome notification after they subscribe. You can also specify a subdomain name, and if you're using iOS and Android notifications you can also enable these options - see :doc:`/channels/push_notifications`. +Editing a Notification +====================== +When you open or create a Notification under Web Notifications, the editor shows a live preview panel beside the **Heading**, **Message**, and **Action Button Text** fields. As you enter text in them, Mautic updates the matching elements in the preview, so you can see how the Notification looks without saving and reopening it. + +When a field is empty, the preview shows default text instead. An empty **Heading** shows 'Notification' and an empty **Message** shows 'You have a new message'. When **Action Button Text** is empty, the action button doesn't appear in the preview. + Sending notifications ===================== There are two ways to send website notifications to the Contact: From 29c13ea17b32685e6f70f012f2e2c2f5b28e926c Mon Sep 17 00:00:00 2001 From: promptless-for-oss Date: Tue, 1 Sep 2026 17:31:15 +0000 Subject: [PATCH 2/2] Address review: wrap Notification heading in Vale off/on and add blank line Reviewer adiati98 on PR #932: - Wrap the 'Editing a Notification' heading in a .. vale off/on block so Vale's sentence-case rule does not flag it; 'Notification' is a capitalized proper noun in the Mautic UI. - Add a blank line between the heading underline and the first paragraph. --- docs/channels/web_notifications.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/channels/web_notifications.rst b/docs/channels/web_notifications.rst index 6a552de62..8576d1712 100644 --- a/docs/channels/web_notifications.rst +++ b/docs/channels/web_notifications.rst @@ -32,8 +32,13 @@ Configuration #. Get the keys from OneSignal under the Settings > Keys & IDs tab. #. Enable the features you wish to use - for example, whether to enable notifications on mobile apps, Landing Pages, tracked resources on your website, and whether to show a welcome notification after they subscribe. You can also specify a subdomain name, and if you're using iOS and Android notifications you can also enable these options - see :doc:`/channels/push_notifications`. +.. vale off + Editing a Notification ====================== + +.. vale on + When you open or create a Notification under Web Notifications, the editor shows a live preview panel beside the **Heading**, **Message**, and **Action Button Text** fields. As you enter text in them, Mautic updates the matching elements in the preview, so you can see how the Notification looks without saving and reopening it. When a field is empty, the preview shows default text instead. An empty **Heading** shows 'Notification' and an empty **Message** shows 'You have a new message'. When **Action Button Text** is empty, the action button doesn't appear in the preview.