FAQ and troubleshooting
Most questions have a one-line answer. This chapter collects the ones merchants ask most, grouped by what you are trying to do, with a pointer to the chapter that covers each in full.
Nothing is showing on my shop
Nine times out of ten this is one of a handful of things. Work down the list — the first match is usually the culprit — and see Setup for where each setting lives.
Is the master switch on?
Nothing appears until the master switch is on. Open the dashboard and check the state pill in the header, or the first item on the setup checklist. One switch turns the whole module off and on.
Are you inside the season window?
If you set a season schedule, the effects show only between the start and end dates you chose. That is the point of it, and it is why the shop clears itself in January: outside the window the module stays switched off by design. Check the dates on the Setup page, or turn the schedule off while you are testing.
Is this page one of the chosen pages?
The effects run only on the page types you ticked — home, category, product and CMS pages. If you are looking at a page type that is not selected, you will see nothing there. Add it on the Setup page.
Is the effect allowed on this device?
The device matrix on the Setup page decides, per effect, whether it runs on desktop, on mobile, or both. An effect that is switched on but turned off for both devices shows nowhere — the setup checklist warns you when that happens. Tick at least one device for each effect you want to see.
Could it be a theme or page cache?
PrestaShop and many themes cache their pages, and combining CSS and JavaScript (CCC) can hold on to an old version of a page. If a change you made in the back office does not appear, clear the PrestaShop cache — and your browser cache — then reload the storefront.
Effects, phones and motion
Do the effects run on phones?
Yes, but considerately. A performance budget scales the effects back on lower-powered devices so your mobile pages stay fast, and the device matrix lets you choose per effect whether it runs on mobile at all. If an effect is missing on a phone, check that its mobile box is ticked and remember that the budget may simply be thinning it to protect page speed. See Experience.
Some visitors see no animation at all. Why?
If Respect reduced motion is on — and we recommend it — any visitor whose browser or system is set to reduce motion will see the effects minimised or stopped. That is working as intended: it is an accessibility courtesy, not a fault. See Experience.
Can a visitor turn the motion off themselves?
If you switch on the visitor pause button, yes. A small floating button lets each visitor pause or resume all the motion, and their choice is remembered on their device. It changes nothing for your other visitors. See Experience.
The selling features
The surprise-gift code does not work
The surprise gift reveals a discount code — it does not create one. The code must already exist as a cart rule in Catalog › Discounts, and the one you enter in the surprise-gift settings must match it exactly. If customers say the code is rejected, open the cart rule and check that it is enabled, within its dates, and still has uses left. See Promotions: the selling features.
Gift wrapping is not offered at checkout
Gift wrap is built on PrestaShop's own gift-wrapping feature. When you turn on Offer gift wrap at checkout, the module switches PrestaShop's gift wrapping on for you; if it is still not offered, check that gift wrapping is enabled in Shop Parameters › Order Settings. The wrap price and tax are computed by PrestaShop itself, so your totals and invoices stay correct. See Promotions: the selling features.
The promotion bar shows no countdown
The bar counts down to the date and time you set, in your shop's time zone. A deadline in the past shows no countdown, so check the date on the Promo bar page if the bar looks empty or has already finished. See Promotions: the selling features.
Performance and housekeeping
Will the module slow my shop down?
It is built not to. Every canvas effect shares one drawing surface and one animation loop, the effects pause while the browser tab is in the background, and the performance budget caps the work on slower devices. Keep Performance budget on, and switch off any effect you are not using. See Experience.
How do I switch everything off quickly?
Turn off the master switch on the dashboard: it hides every effect at once without losing any of your settings. A season schedule does the same thing by date, on its own, each January. See Setup.
How do I uninstall it cleanly?
Uninstall White Christmas from Modules › Module Manager like any other module. It removes its own settings and leaves your theme, catalogue and prices exactly as they were — the effects were only ever laid on top. Gift wrapping stays on if you had switched it on, because that is PrestaShop's own feature; turn it off in Shop Parameters › Order Settings if you no longer want it.