Documentation
Activate Findalo on your store in 10 minutes.
Step-by-step guides for every platform, the API and the panel. If you get stuck, email us at hola@findalo.io — we read everything.
Installation by platform
- Available
PrestaShop 1.7 / 8.x / 9.x
Native module. Compatible with Classic, Hummingbird and custom themes.
- Available
Shopify
Public app: connect your store in one click from the panel and switch the search on in your theme without touching code. No module, no tokens.
- Available
WooCommerce
Official WordPress plugin. Compatible with WPML/Polylang and WP caches.
- Available
Magento 2 / Adobe Commerce
Native module. Downloadable from your panel. PHP 8.2/8.3/8.4. Compatible with Hyvä and PWA Studio.
- Available
Shopware 6
Native app (no PHP). Downloadable from your panel. Compatible with Shopware 6.6 and 6.7, Storefront / Headless.
Minimum technical requirements
What your store needs to install the Findalo module. If your stack falls below this, let us know at hola@findalo.io and we'll see what we can do.
| Platform | Module | Compatible platform | PHP | Other requirements |
|---|---|---|---|---|
| PrestaShop | v1.9.11 Updated Oct 30, 2026 | 1.7.6.0 – 9.x (multi-shop soportado) | 7.2+ (8.1+ recomendado) | cURL y JSON activos · URL de la tienda alcanzable públicamente para sync (endpoint /module/findalo/feed) · cualquier tema (Classic, Hummingbird, custom) |
| WooCommerce | v1.5.2 Listing on WordPress.org ↗ Updated Oct 31, 2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WP 7.1 y WC 11.1) en el directorio de WordPress.org | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.3.8 Listing on Adobe Commerce Marketplace ↗ Updated Sep 11, 2026 | Magento 2.4 Adobe Commerce (Open Source, on-premise y cloud) en Adobe Commerce Marketplace | 8.2 / 8.3 / 8.4 / 8.5 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | App pública Se conecta desde tu panel (Conectar con Shopify) | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Acceso al admin de Shopify con permiso para instalar apps · la app pide leer el catálogo y el inventario (read_products, read_inventory), los eventos de compra para la analítica (write_pixels, read_customer_events) y las páginas y políticas de la tienda para el asistente (read_content, read_legal_policies) · cualquier tema: el buscador se activa como incrustación de app en el editor de temas, sin tocar código |
| Shopware | v0.8.3 App nativa (sin PHP) Updated Sep 8, 2026 | Shopware 6.4 – 6.7+ (App nativa, Storefront) | — | App de Shopware (sin PHP, resiliente a versiones) · instalar vía Extensiones → Subir extensión · Admin API accesible para la sincronización (pull del catálogo) · cualquier tema |
The browser widget works on current Chrome, Firefox, Safari and Edge and the two previous versions. No jQuery or theme dependencies.
PrestaShop — essential steps
Native module for PrestaShop 1.7.6 – 9.x, multistore included. ~10 minutes. The store connects with one button from the module itself: no tokens to copy, no URLs to edit.
- 1 · Install the module
Go to your customer panel (or sign up for free) → Integration → PrestaShop tab → Download ZIP: always the latest published version. In your back office: Modules → Module Manager → Upload a module, drop the ZIP and click Install.
- 2 · Establish the connection
In Modules → Module Manager (①) find Findalo and click Configure. On the Configuration tab click Connect with findalo (②). panel.findalo.io opens: sign in with your Findalo account (or create it right there), pick the search engine and click Connect this store. You come back to the module already connected: the credential travels server to server — you never see or copy it.
- 3 · Check that everything arrives
The module shows ✓ Connected · your-search-engine. The catalog is pushed on its own: in your panel → Sync your products show up within minutes and, from then on, every product, price or stock change arrives automatically. To force a push: the module's Status tab → Mark as pending (force next rebuild), or Sync now in the panel. Reload your storefront and click the magnifier: the search opens with your products.
If you can't use the button
If the panel window doesn't open or the way back to the module breaks (pop-up blocker, redirect broken by the hosting), connect by hand: in your panel → Integration → PrestaShop tab copy the Search engine ID and the Sync token; in the module expand Connection not working? Connect manually, paste both values and click Save manual connection. The result is the same as with the button.
WooCommerce — essential steps
Official WordPress plugin for WooCommerce. ~10 minutes. WPML and Polylang are detected automatically; compatible with WP Rocket and LiteSpeed Cache. Live demo: woocommerce.findalo.io/shop.
- 1 · Install the plugin
In your WordPress: Plugins → Add New, search for “Findalo”, click Install Now and then Activate. You can also upload the ZIP (Upload Plugin) downloaded from your panel (Integration → WooCommerce tab) or from WordPress.org. A short wizard opens on activation; you don't need to finish it: the connection in step 2 sets everything up. No account yet? Sign up for free — or create it during the connection.
- 2 · Establish the connection
In the side menu, WooCommerce → Findalo (①), General tab, Connection card: click Connect with Findalo (②). panel.findalo.io opens: sign in with your Findalo account (or create it right there), pick the search engine and click Connect this store. You come back to the plugin already connected; you never see or copy tokens.
- 3 · Check that everything arrives
The Connection card shows ✓ Connected · your-search-engine and a Verify connection button to check it anytime. The plugin publishes the catalog on its own and keeps it current with every product, price or stock change; in your panel → Sync your products show up within minutes. To force a push: the plugin's Status tab → Mark as pending (force next rebuild), or Sync now in the panel. Open your store and click the magnifier.
If you can't use the button
If the panel window doesn't open or the way back to the plugin breaks (pop-up blocker, redirect broken by the hosting), connect by hand: in your panel → Integration → WooCommerce tab copy the Search engine ID and the Sync token; in the plugin expand Connection not working? Connect manually, paste both values and click Save manual connection. The result is the same as with the button.
Shopify — essential steps
Public Shopify app. ~5 minutes. Nothing to install on a server, no tokens, no code: you connect the store from your Findalo panel in one click.
- 1 · Connect your store
Go to your customer panel (or sign up for free) → Integration → Shopify tab. Type your store domain (
your-store.myshopify.com) and click Connect with Shopify. - 2 · Authorize the app in Shopify
Your store admin opens and Shopify shows the permissions the app asks for (catalog and inventory, purchase events for analytics, and store pages for the assistant): confirm with Install. You land back in your panel with the store connected, and the catalog syncs on its own through the Shopify API. From then on you also have Findalo under Apps → Findalo, inside your Shopify admin and already signed in.
- 3 · Enable the search in your theme
Online Store → Themes → Customize → App embeds (the panel's Open theme editor button takes you straight there), enable Findalo and save. Click your store's magnifier: the search opens with your products. Product, price and stock changes arrive on their own; to force a sync: panel → Sync → Sync now.
If something doesn't add up
The app uses neither tokens nor connection codes. If the search doesn't show up on your store, check that the Findalo app embed is enabled in the theme and that the app is still installed under Apps. Uninstalling the app disconnects the store automatically.
Magento — essential steps
Native module for Magento 2.4 and Adobe Commerce, published on the Adobe Commerce Marketplace. ~10 minutes. PHP 8.2 – 8.5. Compatible with Hyvä and headless storefronts.
- 1 · Install the module
From the Adobe Commerce Marketplace, with Composer (your repo.magento.com keys are in your Adobe account):
composer require findalo/magento-search bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushIn production add
bin/magento setup:di:compileandbin/magento setup:static-content:deployif your pipeline requires them. Without Composer: download the ZIP from your panel (Integration → Magento tab) and unzip it intoapp/code/Findalo/Search— one of the two routes, never both at once. - 2 · Establish the connection
In the Magento admin, side menu Findalo → Configuration (①). On the Configuration tab click Connect with findalo (②). panel.findalo.io opens: sign in with your Findalo account (or create it right there), pick the search engine and click Connect this store. You come back to the module already connected: the credential travels server to server — you never see or copy it.
- 3 · Check that everything arrives
Next to the button you'll see ✓ Connected · your-search-engine. The module pushes the catalog on its own (in multi-store, each store view separately) and keeps it current; in your panel → Sync your products show up within minutes. To force a push: Status tab → Mark as pending (force next rebuild), or Sync now in the panel. If the widget doesn't show on your store, flush caches:
bin/magento cache:flush.
If you can't use the button
If the panel window doesn't open or the way back to the module breaks (pop-up blocker, redirect broken by the hosting), connect by hand: in your panel → Integration → Magento tab copy the Search engine ID and the Sync token; in the module expand Connection not working? Connect manually, paste both values into their fields and click Save. The result is the same as with the button.
Shopware — essential steps
Native Shopware app (no PHP) for 6.6 and 6.7. ~10 minutes. The store is linked to your Findalo account from the admin itself with an emailed code: no tokens.
- 1 · Install the app
Go to your customer panel (or sign up for free) → Integration → Shopware tab → Download ZIP. In your Shopware admin: Extensions → My extensions → Upload extension, install and activate, accepting the permissions (read access to catalog and configuration). Via CLI:
bin/console app:install --activate FindaloSearch bin/console cache:clearOn activation the app registers with Findalo automatically. Requirement: the shop must be reachable over HTTPS from the internet (Findalo reads the catalog through the Admin API).
- 2 · Link the shop to your account
Open Extensions → Findalo. Enter the email of your Findalo account and click Enviar código (send code); type the 6-digit code you receive and click Verificar y vincular (verify and link). In the channel table, assign each Storefront sales channel to a search engine of your account (Buscador column): only the assigned channel is connected and indexed. Need another search engine? Create it in the panel and click ↻ Refrescar (refresh) in the app.
- 3 · Check that everything arrives
You'll see Conectado a Findalo (connected) and, per channel, products and last sync. The catalog syncs through the Admin API and changes arrive on their own; Re-sincronizar forces a push and Gestionar buscadores ↗ opens your panel. The widget is injected into the Storefront automatically: reload your shop and click the magnifier.
If the code doesn't arrive or something doesn't add up
Check your spam folder and that the address is the one of your Findalo account; request another code with Enviar código. Desconectar pauses the search engines without deleting anything: you reconnect with one click, no reinstall. If your Shopware doesn't allow uploading extensions from the admin, use the CLI command from step 1.
Quick resources
API and endpoints
Public base URL: https://api.findalo.io
GET /api/<search-engine>/search?q=<query>- Main search. Returns hits, facets and total. Origin must be in
allowed_domainsof your search engine. GET /api/<search-engine>/suggest?q=<query>- Autocomplete. Call it at typing speed; it has a more generous rate limit than /search.
GET /api/public-config/<search-engine>- Public config of your search engine: theme, layout, plan. What the widget uses at boot.
POST /api/<search-engine>/track- Event tracking (clicks, adds-to-cart, conversions). JSON body.
Detailed documentation with cURL examples and SDKs coming soon. Need something specific now? Write to us.
Recommendations (Pro+ plan)
Suggested product blocks on product pages, cart and homepage — without the shopper making any search. The engine aggregates your view/add-to-cart events with 30-day decay and materialises three indices: co-visited, co-added-to-cart and bestsellers.
Auto-inject (PrestaShop)
The module already includes the displayFooterProduct, displayShoppingCartFooter and displayHome hooks. Configure the back office and activate the slots — zero code.
Custom integration (other platforms)
// On the product page:
findalo.reco({
context: 'similar',
productId: '123',
target: '#findalo-similar-slot',
title: 'You might also like',
});
// When the product page loads:
findalo.trackView('123');
// When adding to cart:
findalo.trackAddToCart('123');
// Recently viewed (client-side, no backend traffic):
findalo.recentlyViewed(); // → ['123', '456', ...] Endpoint
GET /api/<search-engine>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · plan ≥ Pro or returns 402.
Something not working?
Send us an email at hola@findalo.io with your store URL and what's failing. We reply personally during business hours.