Welcome Popup: setup and help

Follow the steps in Quick start.

Open Modules > Module Manager > Welcome Popup > Configure. Check Editing scope and Effective settings from before saving. The whole popup inherits from shop to shop group to global. Saving creates a complete override at the selected scope. Use Inherit popup from parent scope to remove a shop or group override.

You need edit access and access to the affected shops. Global edits require a super administrator. Select a single shop to upload images or posters.

There is no prefilled HTML message in the fresh settings. Add Content blocks, then use Preview and Save.

You can add up to 20 blocks. Use Move up, Move down, and Remove block to manage their order.

• Add text provides Text (safe HTML) for each language. HTML is sanitized. Use simple paragraphs, bold text, and links. Each submitted text value is limited to 12,000 bytes.
• Add image provides Upload or replace image and Image alternative text for each language.
• Add video provides YouTube or Vimeo HTTPS URL, Video title, an optional Upload or replace poster, and Remove poster.

Missing translations and empty media labels fall back to the shop default language. Explicitly empty text blocks remain empty.

Images and posters support JPG, PNG, GIF, and WebP. Each upload is limited to 8 MiB, 8000 pixels per side, and 24 megapixels. Total uploads per save are limited to 16 MiB. Your server's upload limits must also allow the request.

Video links support recognized YouTube watch, embed, shorts, and short-link URLs, plus Vimeo video URLs. YouTube is normalized to youtube-nocookie.com; Vimeo uses dnt=1. Playback starts from the visitor's play action. If MPRCR.isGranted is available, marketing consent must allow the provider. Consent revocation stops playback. Closing the popup or hiding the browser tab also stops videos.

For an announcement, add a text block such as:

<p><strong>Holiday shipping notice</strong></p>
<p>Orders placed this week may need one extra working day for dispatch.</p>

For a visible coupon message, you can use:

<p><strong>Get 10% off your first order.</strong></p>
<p>Use code <strong>WELCOME10</strong> at checkout.</p>
<p><a href="/promotions">View current promotions</a></p>

Create the matching cart rule separately. Popup text does not create a discount.

Enable Show newsletter signup only after configuring the shop's native newsletter module. The popup uses ps_emailsubscription on PrestaShop 1.7 and later, or blocknewsletter on PrestaShop 1.6. That module owns subscription processing, consent controls, verification mail, and result messages.

The popup submits through its token-protected newsletter endpoint and displays the native result. It does not add its own subscriber-management screen. If the native module is missing, disabled, or cannot render a form, the popup can still show content with a visible newsletter error.

The module loads its assets through displayHeader and actionFrontControllerSetMedia. It renders once through displayFooter or displayBeforeBodyClosingTag. It excludes AJAX and non-HTML documents. Homepage only checks the index controller.

After the delay, the shared modal opens when the page is visible and not blocked by the MPR consent interface. Visitors can dismiss the modal through its close controls. The module writes mprwpop_seen_<shop ID> using the shop base path, SameSite=Lax, and Secure on HTTPS. The cookie suppresses later openings in that shop until it expires. A different browser, device, or cleared cookie starts a separate history.

You have timed display, with no exit-intent trigger or customer-group targeting. Layout and color controls are not settings in this editor. Use the current .mprwpop modal and content markup for theme CSS. Start from the current template before customizing; former .mprwpop-overlay, .mprwpop-modal, and mprwpop_message examples refer to the older layout.

1. Add content, use Preview, and confirm block order, translations, and media.
2. Save with Enable = Yes and visit an eligible page in a fresh browser session.
3. Wait for your configured delay and confirm the popup opens.
4. Dismiss it and reload. Confirm mprwpop_seen_<shop ID> suppresses it.
5. If enabled, submit a newsletter test address and verify the result through your native newsletter workflow.

To repeat a test, clear the shop-specific cookie or use a private browser window. Preview opens immediately and does not store a storefront dismissal cookie.

If saving or preview fails, check edit permissions, scope, token, text validation, upload size, PHP DOM support, and image-directory write access. If unused images could not be removed, select the shop and use Retry media cleanup. Check the installation integrity page for missing module infrastructure.

If no popup appears, check Effective settings from, Enable, Show on, the cookie, page visibility, consent-page blocking, footer output, and loaded modal assets. Inspect the browser console for media or stylesheet failures.

Set Enable to No at the intended scope and save. Uninstall from Module Manager to remove configuration, menu, and managed popup media. Uninstall reports failure if owned-media cleanup cannot complete. Back up content and media first. Native newsletter subscriptions are managed by the native newsletter module.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.