Backend configuration
After activating the module, open Stores → Configuration → Catalog → FACT-Finder. Configure the FACT-Finder connection, web components, and export settings there.
Main settings
Enter the shop connection and authorization details. Activate the integration, then select Save Config. You may need to clear the cache through System → Cache Management → Flush Magento Cache. Select Test Connection to verify connectivity.
The channel name, server URL, and API key must be correct.
You can enable FACT-Finder category-page rendering here. See using FACT-Finder on category pages.
Show 'Add to Cart' Button in Search Results adds a cart button to search-result products. It works only for simple products. Configurable products redirect to the product page. The feature identifies products through MasterProductNumber. Import that field to the FACT-Finder backend.
Activate Logging saves communication exceptions to var/log/factfinder.log. This affects server-side communication only.
FACT-Finder version
Version 5 supports only the NG FACT-Finder version. For earlier versions, use the 4.x SDK.
Server-side rendering
This option enables server-side rendering for ff-record-list on category and search-result pages. Pre-rendered product content improves crawler visibility. The module uses Handlebars PHP for template processing.
See the Web Components server-side rendering guide.
Advanced settings
Advanced Settings holds additional Web Components parameters. Each setting has a default value and explanatory text.
Atlas AI support handles Atlas AI requirements automatically. It creates and persists a dedicated Atlas AI user ID. Enabling it overwrites existing logged-in user IDs.
Currency and country settings
No module-specific currency or country setting is required. The module passes the active store values to factfinder init as currency-code and currency-country-code.
Optional custom elements
Some custom elements require additional FACT-Finder modules. Disable those elements when you do not use the related functionality.
Feedback campaigns support only the above search result label. Paging is redundant when ff-record-list uses infinite scrolling. Landing-page campaign IDs use the Magento CMS page identifier.
Custom elements options
Configure element-specific attributes here. The module passes stored values into their matching templates.
Export settings
Choose whether attributes export as individual fields or a multi-attribute field. Multi-Attribute: No adds attributes to FilterAttribute. Yes exports separate columns.
Supported attribute types:
boolean, price, select, and multiselect
all scalar values
Numerical attributes
A numerical multi-attribute exports to the NumericalAttributes column. This simplifies FACT-Finder filter configuration. Configurable attributes always export to FilterAttributes.
CMS export settings
You can export CMS pages for suggest results.
Pages Blacklist excludes pages from export. Use it for pages such as 404 Not Found.
Contact your assigned FACT-Finder representative or Service Desk to start using CMS export. CMS export is available only through a console command.
Data transfer settings
Configure FTP or SFTP connections here. The module generates and transfers shop data to FACT-Finder. FTP uses a username and password. SFTP supports a key or password.
Magento's uploader requires key files to have an extension. Add one, such as .rsa, when needed. Enter a key passphrase when the key is protected.
Enter the upload server, then select Test Upload connection. The generated CSV uses double quotes (") as its enclosure and semicolons (;) as delimiters.
Before selecting Generate Export File(s) now, select Save Config. Test Connection always uses the fields' current values.
Updating field roles
When field roles change in FACT-Finder, update the Magento tracking values with Update Field Roles.
Automatic import
After uploading a feed, FACT-Finder must import it. Enable automatic import to trigger that step after each upload. Choose one or more data types:
Search
Suggest
Recommendation
Last updated
Was this helpful?






