Getting users to subscribe to push notifications is an important aspect of setting up push notifications. In this document we present ready-made user interfaces we've created to help you do just that with minimal effort. These user interfaces are: * a widget with a “bell” icon that stays available at the bottom left of the page, * a native prompt that appears under conditions determined by you, * an HTML dialog that can be customized and appears under conditions determined by you, * an inline link that you can insert automatically inside elements matching a CSS selector and customize its texts and icon, * a cross-domain popup window you can use to subscribe users from another domain, * a switch you can place anywhere on the page. While the subscription dialog and the bell widget can be completely configured from your dashboard, the switch require a little bit of code. For even more flexibility and customization, you can use [Push subscription popup](doc:push-notification-subscribe-popup) to trigger subscription prompts at the right moment in the user journey. You can customize the promps in the [Website settings screen](doc:dashboard-platforms#website).

## Deciding where on your site to show each prompt All subscription prompts (except the Cross-domain dialog) let you choose on which URLs they appear.

#### Only show on some URLs When you check "Only show on URLs containing...", you restrict the prompt to URLs that contain at least one of the lines in the textarea. For example, if you only show on URLs containing: ``` /products/ /categories/ ``` Then the prompt will only appear on pages that have `/products` or `/categories` in their URL. Typically not your homepage, or terms and conditions page. #### Do NOT show on some URLs When you check "Do NOT show on URLs containing (one string per line)", you restrict the prompt to URLS that do NOT contain ANY of the lines in the textarea. For example, if you do not show on URLs containing: ``` /terms/ /contact/ ``` Then the prompt will appear on all pages of your website, except those that have `/terms/` or `/contact/` in their URL. Typically your terms and conditions page, and your contact page. #### Combining "Only show\..." and "Do NOT show" You can put things in both textarea, they will combine. Be careful to avoid putting the same strings inside both textareas: your prompt would never appear. **Do not do this:**

On the other hand, this is fine: ![](https://files.readme.io/8fe34f2-Screenshot_2023-05-25_at_16.45.07.png) In the above case, this URL would show the prompt: `https://www.mysite.com/products/pants.html` And this wouldn't: `https://www.mysite.com/products/pants.html?no-prompt=true` ## Custom button click You can have any HTML button or link prompt for push notification permission. This is easily achieved by adding a simple `onclick` attribute like this: ```html Click me to subscribe ``` ## Subscription bell widget The subscription bell widget is the easiest way to subscribe users. Users can use the subscription bell to: * Subscribe to push notifications * Opt out of push notifications * Download personal data * Clear personal data The subscription bell sits at the bottom left or right corner of the page and looks like this:\

#### Basic setup You can configure it directly from your dashboard: go to *Settings / Website* and make sure the subscription bell is active:

#### General settings To customize the subscription bell, click the *Customize* link.

##### Language The subscription bell natively supports English and French and will switch automatically to the most appropriate based on the browser language. To force to a particular language, choose one here. ##### Position By default the bell is displayed on the lower-left corner of the screen. Use this dropdown menu to set the position on the lower-right corner. ##### Color Controls the color of the subscription bell widget. ##### Bell icon Use this to change the bell icon. The file you provide will be used as a mask so it must be transparent. ##### CSS z-index Controls the “altitude” of the bell widget on the page. Raise this value if something on the page is displayed on top of the bell. ##### Show unread-like badge When this is active, the bell will display an unread-like count until the user places his mouse over the bell. #### Texts Use this section to customize the texts displayed by the bell widget.

#### Unsubscription dialog

The bell widget allows users to unsubscribe without losing the push permission. This allows them to sign-up again easily later. If you do not wish to let the bell unsubscribe users, check “Hide the bell to subscribed users”. Other settings in this section let you customize the texts that appear in the unsubscription dialog. #### Privacy settings The bell lets users download or clear their WonderPush data.

If you do not wish to display these privacy settings, check “Hide privacy settings”. #### Internationalization The bell natively supports English and French. To support another language, you can use the above settings: they let you customize all the texts used by the bell widget. You can also use the [subscription bell init options](doc:website-sdk-reference#subscription-bell-options) to support more than one extra language. ## Native prompt This native dialog is the most straightforward way to let users subscribe. To setup the native dialog, make sure it is active in *Settings / Website*: