Install on PrestaShop
On PrestaShop, the Humind module injects the Humind widgets on your storefront for you. There is no snippet to paste in your theme.
Not on PrestaShop?
See Install the chat for the HTML snippet that works on any site.
1. Install and connect the module
Follow PrestaShop catalog sync: install the module, then click Connect to Humind. The connection also allows the domain of your shop, which Humind requires before the widgets load.
Two cases where the domain is not allowed for you:
- You entered an API key by hand: add your domain on the URL whitelist page yourself (Humind asks for a DNS TXT record to prove that you control it).
- You connected in one click, but a firewall or a security service (Cloudflare, for example) blocked the proof call that Humind makes to your shop: the module page then shows a warning with an Allow my domain link to that same page. Humind has already opened the request for your domain there: add the DNS TXT record it shows and verify the domain (the request stays open for 24 hours). The same warning appears when the domain is already linked to another Humind company.
2. Check the widget switches
Once the shop is connected, the On your shop panel of the module configuration page has one card per block, each with its switch:
| Switch | What it adds | Default |
|---|---|---|
| Chat assistant | The Humind chat on every page of the storefront, except the checkout. | On |
| Product questions | AI-generated questions about the product, under the add-to-cart button of product pages (hook displayReassurance). | On |
| Gift finder | The "ask anything" search block on the home page (hook displayHome). | Off |
Chat assistant and Product questions are on as soon as the shop is connected. If your theme already carries the Humind widget (pasted by hand), remove it from the theme.
Product questions and Gift finder open the chat: they only appear while Chat assistant is on and the chat is attached to the page. Otherwise their card says Needs the chat assistant: it does not appear while the chat is off., the block is not rendered and a pasted code shows nothing.
The look and the texts of the widgets are configured in your Humind dashboard, not in the module: each card has a Customize link to the right page.
The module registers the Humind loader scripts through the theme asset manager (deferred, at the bottom of the page) and adds the elements itself. For the chat, it adds <humind-widget> with the attributes you would otherwise set by hand: your company (company-id, or shop-domain when the module has no company ID), the type of page (template-name, see the values), the language and the country, and on product pages the product the visitor is looking at (product-id). It announces itself with integration="prestashop", which resolves product-id against your synchronized catalog and turns on the native cart, the order attribution and the signed-in customer. The product questions and the gift finder carry integration="prestashop" too. A theme that does not call the end-of-page hook still gets the chat: the module adds it to the finished page.
Switch a widget off and click Save to remove it from the storefront without disconnecting the catalog sync. If your theme caches pages, clear the PrestaShop cache after changing a switch.
On a shop served from localhost, enter an API key and your Company ID under Advanced options in the module and allow localhost in your Humind dashboard, so the widgets load.
3. Choose where each block appears
The cards of Product questions and Gift finder set the places of their block, with one checkbox per place, grouped by page: tick the places, then click Save. The chat has no place to choose: it is on every page. The module reads the templates of your active theme and only lists the places the theme really has (a place already chosen stays listed). Each card tells where its block is: Appears here: followed by the places, Will appear here once it is on: while the block or the chat is off, or No active place.
| Page | Places | Gift finder | Product questions |
|---|---|---|---|
| Home page | In the content | Yes, by default | No |
| Category page | Top, Bottom | Yes | No |
| Product page | Top, under the images; Under the cart button; Bottom | Yes | Yes, by default under the cart button |
| Cart | Under the cart | Yes | No |
| Footer of every page | Above the footer; In the footer | Yes | No |
A block appears once per page, however many places ask for it, and only while its switch and the chat are on.
Codes to paste
To put a block inside your content, paste its code in a CMS page, a product description, a text module or a page builder. The code is replaced by the block on your shop.
| Code | Block |
|---|---|
[humind bloc="generateur"] | The gift finder. |
[humind bloc="questions"] | The questions of the current product. Outside a product page, nothing is shown. |
A code is rendered in the content of the page only. In the page head or inside a tag (meta description, structured data), it is removed. With the switch of the block off, with the chat off, or when the block is already on the page, the code shows nothing. Each card also shows the code of its block. The codes are left out of the descriptions and pages sent to Humind, so the assistant never reads them.
Other positions of the theme
Under Design > Positions, the module can also be placed on any other position of your theme: it shows the product questions on a product page and the gift finder elsewhere. In a template, use {widget name="humind" block="questions"} or {widget name="humind" block="gift_finder"}.
After a change of theme
Activating a theme, even the one already active, can take every module off the hooks the theme lists, as the classic theme of PrestaShop 8 does on displayHome and displayReassurance. The module puts its blocks and the chat back right after, on that shop. A removal under Design > Positions on a hook the theme leaves alone stays. On a hook the theme does clear, PrestaShop has already wiped the removal, so the place chosen on the module page comes back: untick it there to remove it for good.
When a block or the chat is no longer attached to its place (removed under Design > Positions or by a theme), the module page shows a warning:
- for a block, click Save to put it back;
- for the chat, click Put the assistant back. The blocks that need it come back with it.
Verify
- On the module page, in the Chat assistant card of the On your shop panel, click Check my home page. The module reads your home page as a visitor gets it and tells you whether the chat is in it.
- Open a page of your shop in a private window.
- Open the browser DevTools, Network tab. You should see
GET https://embed.thehumind.com/loader.jsreturn 200, and no console error. - In the console,
document.querySelector('humind-widget')should return the element, and the floating chat button appears at the bottom right of the page. - On a product page, the floating button is hidden by design (the visitor starts the conversation from the product questions block). Check the same
document.querySelector('humind-widget')and that the element has aproduct-idattribute andintegration="prestashop". - On the checkout, no Humind widget is loaded.
If the widget does not show
- Check my home page says the assistant is missing. Clear the cache of PrestaShop and of any cache or optimization module, then check again. If it is still missing, your theme or one of its modules removes it: send the name of your theme to Humind.
- Check my home page cannot read the page. A maintenance page or a firewall can give this result. Check the home page in a private window of your browser.
- The module page says that the chat assistant is no longer attached to your pages. It was removed under Design > Positions or by a theme. Click Put the assistant back.
- The browser console mentions an unauthorized domain. The domain of your shop is not in the URL whitelist. Add it exactly as visitors see it (with or without
www, as in the address bar). - No
humind-widgetelement in the page source. The module is not connected, the Chat assistant switch is off, or a cache serves an older version of the page. Clear the PrestaShop cache and any CDN or page cache in front of the shop. - The element is there but nothing appears. An ad blocker, or a content security policy that blocks
embed.thehumind.com(andwidgets.thehumind.comwhen Product questions or Gift finder are on). See Troubleshooting. - No product context on a product page. Check that the product was synchronized (see PrestaShop catalog sync): the widget only knows the products that exist in Humind.
- The cart counter of the theme does not move after an add from the chat. The product is in the cart. See Limits.
Next
- Product questions: the inline block for product pages.
- Gift finder: the search block of the home page.
- Add to cart: how the widget adds to the real PrestaShop cart.
- Install the chat: all the attributes of the widget.