User Guide

Setting Up Permission Request Prompt

In your account, go to Settings ā†’ Web Push, select the site, and click Edit.

Web Push settings page listing a connected website with the Edit button highlighted and Settings selected in the account dropdown menu

Permission Settings

In the Permission settings window, the active tab will correspond to the type of subscription you selected when adding the website to your Reteno account. If you select Double Opt-in, the Custom dialog window type will be active by default.

If necessary, select another type and proceed to the settings.

Permission settings window with four subscription window options: Widget, Custom dialog, and Panel under Double Opt-In, and Default dialog under Single Opt-In

Activate the Show prompt sample to preview how the request will look.

Permission settings window with the Show prompt sample toggle highlighted and turned on, displaying a sample desktop notification permission prompt

Double Opt-in

The advantage of the double opt-in subscription is the ability to customize the appearance of the subscription and confirmation windows. In this case, a user will first see your customized window, and then the standard one.

There are three types of double opt-in subscription windows:

  • Widget ā€” a window with an icon that appears in the bottom right or bottom left of the browser.
Permission settings window with the Widget subscription type selected, showing a sample notification prompt in the bottom left corner
  • Custom dialog ā€” appears in the top left corner of the page.
Permission settings window with the Custom dialog subscription type selected, showing a sample notification prompt in the top left corner
  • Panel ā€” a bar that appears across the full width of the page, at the top or bottom.
Permission settings window with the Panel subscription type selected, showing a sample notification bar across the top of the page

Let's consider the settings for each of them.

Widget

The widget will remain on the screen until the user allows or denies receiving push notifications. After the reminder, users who have unsubscribed will be able to turn on notifications again.

The following settings are available for the widget:

Widget settings panel showing Background color, Icon, Placement, Animation, Show unblock reminder, Permission prompt and button text, and Permission display options numbered 1 through 8
  1. Background color: Select the background color of the widget icon from the palette, or enter the code in HEX or RGB format.
Widget background color picker open with a color palette, HEX/RGB input, and swatches, with green applied to the widget icon
  1. Icon: Click Change image and select an icon for the widget in JPEG or PNG format, up to 200 KB in size.
Widget Icon setting with the Change image button highlighted for uploading a custom notification icon
  1. Placement: Bottom left or bottom right corner.Ā 
Widget Placement setting with Bottom left corner and Bottom right corner options and Side/Bottom padding fields

Set the widget's paddings ā€” from the side or bottom. The maximum value is 300 px.

Widget settings with the Side and Bottom padding fields highlighted, both set to 20 px
  1. Animation: Select the type of animation to attract extra attention.
Widget settings with the Animation dropdown set to None
  1. Show unblock reminder

Activate the option so that users can see the actions they need to take if the subscription request is blocked.

Widget settings with the Show unblock reminder toggle highlighted and turned on

The following settings are available for this option:

  • Widget text and reminder text
Widget text and Reminder text fields highlighted with their default messages and Preview toggles
  • Reminder display: right after or a certain period after blocking.
Reminder display options with the day/hour dropdown open next to the days-after-blocking setting

Activate the Preview switch to see how the reminder will look.

Widget text, Reminder text, and Reminder display settings with Preview toggles, alongside Permission prompt, Block button, and Allow button text fields
  1. Permission prompt and button text: Click the text field and enter the information that will be displayed on the buttons and in the prompt.
Widget Permission prompt, Block button, and Allow button text fields highlighted, with a sample notification prompt shown
  1. Text color, background color, and button color: Click the corresponding field, select a color from the palette, or enter the code in HEX or RGB format.
Widget Allow button color picker open with a color palette and HEX/RGB input, setting a blue button color
  1. Permission display

Set the parameters:

  • Show upon: page load or click.

If you set Show upon click, the request window will appear after the user clicks on a specific element on the website (banner, button, etc.). Add class="es-push-prompt-init" to this element in the websiteā€™s code;

  • Time delay after entering the website before prompt display. The maximum value is 1000 seconds.
Widget Permission display settings with Page load selected under Show upon and the time delay field highlighted
Multilanguage

Use the multilingual option in widgets to automatically address users in their languages. Learn more >

Permission settings page with the language dropdown open, showing the Specify the default language option highlighted

Custom dialog/Panel

They have similar settings, with one difference ā€” for the Panel window type, you can select the placement of the permission prompt: top or bottom

Permission prompt settings with the Permission prompt placement options Top and Bottom highlighted, alongside Permission display settings

The method of changing the settings is similar to that of the Widget*.

Single Opt-in

The default browser window, where you can only configure the Permission Display option.

Permission settings page with the Default dialog subscription type selected under Single Opt-In, showing a sample browser notification permission prompt

Click the Save button in the top menu to save the subscription request settings.

Permission settings page with the Save button highlighted

Features of Permission Settings for Safari

In the general subscription request settings window, you can also add your custom brand logo, which will be displayed for Safari users on macOS. For subscribers using other browsers, you can set any other image while creating the messages.

Click Change image and select a logo for Web Push in JPEG or PNG format, with a size of up to 200 KB. The image must be square-shaped with a minimum resolution of 256x256 px.

Default icon for web push notifications section with the Change image button highlighted

Updated 4 days ago

Did this page help you?