Skip to main
← Index

Install Walityk on PrestaShop

Install guide for the Walityk tag on PrestaShop 1.7 and 8.x, with GA4 and Meta CAPI connection.

This guide covers installing Walityk on a PrestaShop store (1.7, 8.x). Installation is a snippet placed in the theme’s <head> — no dedicated module to install. Plan for 10 minutes.

1. Create your site in the dashboard

  1. Open the Walityk dashboard → Sites → New site.
  2. Enter your store’s domain and pick the PrestaShop platform.
  3. Click Create site. The Installation tab shows your ~10-line snippet with your site ID already filled in:
<script>
(function(s,i,e){
  s.__tftq=s.__tftq||[];
  s.__tftq.push(['init',{site_id:i,endpoint:e+'/collect'}]);
  var t=document.createElement('script');
  t.async=true;
  t.src=e+'/tag.js';
  document.head.appendChild(t);
})(window,'YOUR_SITE_ID','https://tag.walityk.com');
</script>

Running multistore across different domains? Create one Walityk site per domain.

2. Place the snippet in the theme

Two options:

  1. PrestaShop admin → Design → Theme & Logo to identify your active theme.
  2. Edit themes/<your-theme>/templates/_partials/head.tpl (via FTP or your host’s file editor).
  3. Paste the snippet just before </head> (end of file), save.
  4. Clear the cache: Advanced Parameters → Performance → Clear cache.

Via an HTML-insertion module

If you’d rather not touch the theme, any free code-insertion module (“Custom JS/HTML”) that injects into the displayHeader hook works: paste the snippet there.

The snippet is non-blocking (async): no impact on store speed.

3. Enable ecommerce auto-detection

On your site’s page in the dashboard, enable Ecommerce auto-detection. The tag infers events from the structured data PrestaShop emits natively (JSON-LD / Open Graph) and standard buttons:

  • view_item on product pages
  • add_to_cart on “Add to cart” clicks
  • begin_checkout on checkout entry (/checkout, /commande)
  • purchase on the order confirmation page

It’s a heuristic: after enabling, check in live events that all 4 events come through on your theme (official Classic and Hummingbird themes are recognized; a heavily customized theme may need a manual event — see troubleshooting). The tag also emits page_view, scroll milestones, outbound clicks and form_submit automatically.

4. Connect your destinations

On Destinations in the Walityk dashboard:

  • GA4: Measurement ID + API secret.
  • Meta CAPI: Pixel ID + Conversions API token.
  • Google Ads: connect your account if you run paid campaigns.

5. Verify events are flowing

  1. In the dashboard, open your site’s page → View live events.
  2. Browse your store: home, product page, add to cart, checkout.
  3. Check Meta Events Manager → Test events and GA4 → Realtime.

Not working?

  • No events: clear the PrestaShop cache (Advanced Parameters → Performance → Clear cache) then check in the page source that the snippet is present in the <head>. Open DevTools → Network and look for tag.walityk.com.
  • /collect request blocked by CORS: the store’s domain doesn’t match the domain declared in the dashboard — fix it.
  • Missing purchase: some custom checkout funnels aren’t recognized by the heuristic. Push the event manually on the confirmation page: __tftq.push(['track', 'purchase', { value: 49.00, currency: 'EUR', transaction_id: 'ORD-1234' }]).

Compatibility

  • ✅ PrestaShop 1.7.6+, 8.x
  • ✅ Official themes (Classic, Hummingbird) for ecommerce auto-detection
  • ✅ Multistore (one Walityk site per domain)
  • ⚠️ PrestaShop 1.6: the snippet works, but auto-detection isn’t guaranteed — plan for manual events

Need help? hi@walityk.com.