Troubleshooting
First of all: check the Status panel of the configuration page. If it is orange, the FAQ is simply hidden from visitors (see Settings).
Clear the cache
This fixes many problems after installing or updating.
- Advanced Parameters > Performance.
- Clear cache, at the top right.
- Reload the shop page (on a computer, Ctrl + F5 or Cmd + Shift + R).
AnswerKit clears its own FAQ cache on every change of a question or setting. The general PrestaShop cache must be cleared after each install or update of the module, especially when Smart cache for CSS is on.
The FAQ is in the page code, but not on screen
The theme does not show the chosen location, or the cache serves an old version.
- Clear the cache (above).
- In Where FAQs are used, pick a location that works with every theme:
- product pages: Own block after the description;
- categories, brands, CMS pages: End of the page content, works with every theme;
- home page: End of the page content if your theme does not show In the home page sections.
- Save and reload the page.
The Below the product list, Classic theme and Above the product list, Classic theme locations do not exist in every theme: many marketplace themes remove them.
The FAQ does not show on the product page
- Your theme must show module content after the description (
displayProductExtraContent). Classic, Hummingbird and the adlx theme do. If yours does not, try Bottom of the product page, or place the widget (see Advanced uses). - The Product pages scope must be set to Yes.
Compatibility per theme
| Theme | Product page | Categories, brands, CMS |
|---|---|---|
| Classic (PrestaShop 8) | Tab after Description and Product Details | Every location |
| Hummingbird (PrestaShop 9) | Collapsible section under the description | End or Top of the page content |
| adlx theme | Tab or section, depending on the chosen layout | End or Top of the page content |
| Other themes (Cartzilla, Warehouse…) | Own block after the description in general; otherwise Bottom of the product page | End or Top of the page content |
The accordion shows without style
AnswerKit’s CSS is not loaded: clear the PrestaShop cache (the combined CSS file still holds the old list of files). If your theme forces its own list or heading styles, adjust the colors with the CSS variables described in Advanced uses.
The block shows twice
- You have a location chosen and the
{widget name='answerkit'}widget in the theme: set the location to None, the theme places the widget. - Two FAQ modules show the same question: see the FAQ.
Google’s test reports two FAQPage items
Another module or the theme also writes a FAQPage block. Turn one off: in AnswerKit, set Add FAQPage structured data to No. See Structured data.
The product FAQ tab stays on “Loading…”
Reload the product page. If it persists, clear the cache and check that the module is up to date: versions before 1.4.0 had this bug on PrestaShop 9.
A question shows its number instead of its text in the back office
It has no text in the back office language. Open it and fill in at least the default language, marked with a star.
The CSV import refuses the file
- Missing columns: the first row must hold
item_ref;active;links;lang;question;answer. - This file is not a text CSV file: in Excel, Save As CSV UTF-8 (Comma delimited), not .xlsx. Semicolons and commas are both accepted.
- Over 5 MB or 20,000 rows: split the file.
Uninstall
Uninstalling deletes every question, their links and the settings, and removes the module’s API rights. Before uninstalling:
- Catalog > FAQ (AnswerKit) > Export all questions (CSV) to keep a copy.
- Modules > Module Manager, AnswerKit, action menu, Uninstall.
To hide the FAQs without losing anything, set Show FAQs to visitors to No instead, or disable the module. To update, never install after an uninstall: just upload the new zip (see Installation).
Still stuck?
Write to hello@adlx.studio with your PrestaShop version, your theme, the AnswerKit version (at the bottom of the configuration page) and the address of a page concerned.