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.
- Beta — self-service
Shopify
Custom App + snippet in theme.liquid. Official app on Partners on its way.
- 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 plugin. Downloadable from your panel. Compatible with Shopware 6.6+ and 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.6.14 Updated Jun 9, 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.2.2 Updated Jun 4, 2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WC 9.4) | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.1.8 Updated Jun 8, 2026 | Magento 2 Adobe Commerce (Open Source y Commerce) | 8.2 / 8.3 / 8.4 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | Custom App App pública en camino | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Permiso para crear Custom Apps · scopes read_products, read_product_listings, read_collections, read_inventory · acceso a theme.liquid para pegar el snippet |
| Shopware | v0.2.4 Updated Jun 8, 2026 | Shopware 6.6+ (Storefront y Headless) | 8.2 / 8.3 | Shopware CLI o admin para subir plugin · acceso al Storefront para inyectar el snippet del widget · MySQL 8 / MariaDB 10.4+ |
The browser widget works on current Chrome, Firefox, Safari and Edge and the two previous versions. No jQuery or theme dependencies.
PrestaShop — essential steps
- 1 · Download
Go to your customer panel and open Integrations → PrestaShop Module. Click Download ZIP — we always give you the latest published version. Don't have an account yet? Sign up for free.
- 2 · Upload and install
In PrestaShop BO: Modules → Module Manager → Upload a module. Drag the ZIP and click Install.
- 3 · Configure
Click Configure on the Findalo module. Fill in:
- Search URL: the slug you have in your findalo.io panel (visible as soon as you register).
- Feed token: leave it empty to auto-generate a strong one. Copy it afterwards to your findalo.io panel.
- Trigger selector: leave it as default (covers the Classic theme and the majority). Only change it if your theme uses custom selectors.
- 4 · Activate
Check "Load the search bundle on all pages" and save. Reload your storefront, click the theme's magnifying glass — the widget opens a full-screen modal and products appear instantly.
- 5 · Verify the sync
In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If not, check that your PrestaShop is reachable from the internet (sync polls every 5 min at the endpoint
/module/findalo/feed).
WooCommerce — essential steps
Standard WordPress plugin. ~10 minutes. Compatible with WPML, Polylang, WP Rocket, LiteSpeed Cache and Storefront / Hello Elementor / Astra / Blocksy themes. Live demo: woocommerce.findalo.io/shop.
- 1 · Download the plugin
Go to your panel → Integration → WooCommerce tab → Download ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.
- 2 · Upload and install in WordPress
In your WordPress admin: Plugins → Add new → Upload plugin. Drag the ZIP and click Install, then Activate.
- 3 · Configure the plugin
In the WooCommerce → Findalo menu. Fill in:
- Your search URL: the slug you see in your findalo.io panel (you choose it at sign-up).
- Feed token (Bearer): the one shown in the findalo panel — copy and paste it here. If it's empty, the plugin generates one and you copy it to the panel afterwards.
- Trigger selector: leave it as default — covers the Gutenberg search block, classic search-field and the product search form.
Save. The plugin injects the widget into
wp_headautomatically. - 4 · Force the first sync
On the same plugin settings page, click "Mark as pending (force next rebuild)". Wait 5–10 seconds. The plugin builds the catalog JSON and posts it to findalo.io (async push — the page returns without waiting for the upload).
- 5 · Verify
In findalo.io → your search engine → Synchronisation: you should see products synced with
sync_source: push. Open your storefront, click the magnifying glass — the findalo modal opens with your products. From now on any change in product, stock or price will be reflected in ≤10 min (stock throttle anti-spam). - 6 · Multi-language support (optional)
If you use WPML or Polylang, the plugin detects them automatically and publishes each translated product under its locale (2-letter ISO). No extra configuration.
Shopify — essential steps
While the official app reaches the Shopify App Store, the connector works
in Custom App mode. ~10 minutes end to end. Use the
demo dev store (pass 1234)
as a reference for how it looks.
- 1 · Sign up for findalo
Register at findalo.io (Free plan is enough to test). Note your slug — you'll need it in the last step.
- 2 · Create a Custom App in Shopify
In your Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Give it any name (e.g. "findalo-search").
- 3 · Enable the scopes
Inside the app: Configuration → Admin API integration → Configure. Check:
read_productsread_product_listingsread_collectionsread_inventory
Save at the bottom right.
- 4 · Install the app and copy the token
Click Install app at the top right. You'll land on API credentials: copy the Admin API access token (starts with
shpat_and is 38 characters long).⚠ Shopify shows the token only once. If you make a mistake or close the tab, you'll need to rotate credentials and generate a new one.
- 5 · Connect findalo in the panel
In your findalo panel: Integration → Shopify tab. Paste:
- Domain:
your-store.myshopify.com - Admin API access token: the
shpat_…from step 4
Click Connect and sync. We validate credentials against Shopify and pull your catalog in seconds. You'll see "Connected to
your-store.myshopify.com". - Domain:
- 6 · Paste the snippet into the theme
In Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Just before
</body>:<script src="https://widget.findalo.io/widget.js" data-tenant="YOUR_SLUG" defer></script>Replace
YOUR_SLUGwith the slug from step 1. Save. Reload your storefront and click the magnifying glass — the findalo widget opens the modal with your products. - 7 · Continuous automatic sync
From here on: the findalo cron pulls every 5 min. You change prices, stock or products in Shopify → findalo re-indexes automatically in under 5 minutes. Zero infrastructure on your end. To force a manual sync: panel → Synchronisation → Sync now.
Magento — essential steps
Native module for Magento 2 and Adobe Commerce. ~10 minutes. Requires PHP 8.2, 8.3 or 8.4. Compatible with Hyvä Themes and PWA Studio / headless storefronts.
- 1 · Download the module
Go to your panel → Integration → Magento tab → Download ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.
- 2 · Upload the module to your Magento
Unzip and copy the folder to
app/code/Findalo/Searchin your Magento. Via SSH:mkdir -p app/code/Findalo/Search unzip findalo-magento-*.zip -d app/code/Findalo/Search - 3 · Enable the module
From the root of your Magento:
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 it. - 4 · Configure
In Magento Admin: Stores → Configuration → Findalo → General. Fill in:
- Search URL: the slug you see in your findalo.io panel.
- Feed token: copy it from the findalo panel and paste it here, or leave empty to auto-generate it.
- Trigger selector: leave as default — covers Luma, Blank and Hyvä themes.
Save and flush caches:
bin/magento cache:flush. - 5 · Verify the sync
In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If you run multi-store or multi-website, each view is indexed separately and identified by its
store_code. Reload your storefront, click the magnifying glass — the widget opens the modal with your products.
Shopware — essential steps
Native plugin for Shopware 6.6 and above. ~10 minutes. Compatible with classic Storefront and headless storefronts.
- 1 · Download the plugin
Go to your panel → Integration → Shopware tab → Download ZIP. We always give you the latest published version. If you don't have an account yet, sign up for free.
- 2 · Upload the plugin to Shopware
In your Shopware Admin: Extensions → My extensions → Upload extension. Drag the ZIP. Via CLI:
bin/console plugin:refresh bin/console plugin:install --activate FindaloSearch bin/console cache:clear - 3 · Configure
In Shopware Admin: Extensions → Findalo Search → Configure. Fill in:
- Search URL: the slug you see in your findalo.io panel.
- Feed token: copy it from the findalo panel and paste it here, or leave empty to auto-generate it.
- Trigger selector: leave as default — covers the default Storefront themes.
Save. The plugin injects the widget into the Storefront automatically.
- 4 · Verify the sync
In findalo.io → your search engine → Catalog status: you should see your products indexed in under 5 minutes. If you run multi-sales-channel, each one is indexed separately. Reload your Storefront, click the magnifying glass — the widget opens the modal with your products.
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.