Doofinder for Magento 2

Transform your Magento 2 search into a conversion machine. Join thousands of merchants using AI-powered search to increase sales and improve customer experience.

🚀 Get Started for Free | 🖥️ Live Demo | 📖 Full Documentation

Why Doofinder?

Doofinder turns your basic search bar into an advanced discovery engine. Using AI-powered searchandising and recommendations, we drive measurable gains in conversion and product discovery.

Key Features

• AI Assistant — A smart shopping guide that helps customers find products through natural conversation.
• AI Smart Search — Understands intent and handles typos or synonyms effortlessly.
• Searchandising — Boost, hide, or pin products to run targeted campaigns.
• Personalized Recommendations — Intelligent cross-selling based on real customer behavior.
• Visual Search — Let your shoppers find products using images.
• Auto-Indexing — Your catalog stays in sync automatically as you scale.

🛠 Installation & Quick Start

From Adobe Marketplace
Install Doofinder from the Adobe Commerce Marketplace directly from your Magento admin, or via Composer:

composer require doofinder/doofinder-magento2
bin/magento setup:upgrade

From GitHub (latest release)
Download the latest release zip and install it as a local Composer package, or copy directly into app/code/Doofinder/Feed.

Then
Complete setup using our step-by-step installation guide.

Requirements

👨‍💻 Development & Maintainer Guide

This repository is optimized for local development using a Makefile and Docker.

.env sits at the repo root and powers both your Docker stack and the generated module files (what doofinder-configure pulls from templates/). It ships with sensible defaults — set your BASE_URL, Magento version, and Composer auth credentials, then make init. Optional overrides go in .env.local, which loads on top of .env.

[!NOTE]
make doofinder-configure regenerates Doofinder/Feed/etc/config.xml and Doofinder/Feed/Helper/Constants.php from templates/. Many other targets depend on it — do not commit those files with non-production values.

Environment and shop access

The root .env lists all variables with comments. For the dev stack, these are the ones you usually touch first:

Default access (Docker dev stack): After make init, the stack runs on the ports defined in docker-compose.yml (default mapping: 9012 → HTTP, 4012 → HTTPS). With the default BASE_URL=localhost from .env:

Admin login is MAGENTO_ADMIN_USER / MAGENTO_ADMIN_PASSWORD from .env (defaults: admin / admin123).

Use cases:

• First-time setup: Run make init to build images, install Magento, and start containers. Use make init-with-data to also load sample data.
• Install the Doofinder module: after make init, follow the installation guide. Alternatively, use make doofinder-upgrade from the CLI.
• Start / stop the stack: make start, make stop.
• Uninstall the module: make doofinder-uninstall.
• Reinstall the module: make doofinder-reinstall.
• DB snapshot: make db-backup (optionally make db-backup prefix=_name). Restore with make db-restore file=backup.sql.gz.
• Code quality check: make consistency (runs PHP Code Sniffer inside Docker with the Magento2 standard).
• Shell in the web container: make dev-console.
• Start from scratch: Run make clean to drop Docker volumes and ./app; type DELETE when prompted, then run make init for a fresh Magento.
• Debug with Xdebug: The stack enables Xdebug via XDEBUG_CONFIG in docker-compose.yml. Set XDEBUG_HOST and XDEBUG_KEY in .env or .env.local, configure your IDE to listen for connections, and browse the shop.
• Varnish: Included but commented out in docker-compose.yml. Uncomment to enable; remember to comment the 9012:80 port in the web container. See Configure the Commerce application to use Varnish.

Compatibility Matrix

PHP 8.0 is not supported by Magento 2. PHP versions below 7.4 are not recommended.

Support & Contributing

• Need Help? Visit our Support Portal.
• Found a Bug? Please contact Doofinder Support.
• Want to contribute? PRs are welcome! Before pushing, make sure PHP Code Sniffer passes — use make consistency or run composer install && vendor/bin/phpcs directly (requires PHP >= 8.3).

If you find this plugin useful, please give us a ⭐ to support the project!

Try Doofinder / Learn more

Ready to improve your store search? Get started with Doofinder for Magento 2.

• XML Feed and all related components (logs, cron, scheduler, configuration on backend, frontend controllers) were deleted, except Generator\Map\Product, which is needed for indexing Doofinder fields
• Information about the Feed was deleted from the Config controller
• AtomicUpdates were deleted- they were replaced entirely by Delayed Updates
• Delayed Updates are set as default and they are disabled in the configuration. They work only during Index on Save
• All products, which are visible in the shop are indexed now. Their appearance in Search or in the Catalog depends on correct setting of their Visibility in admin panel
• Doofinder attributes are indexed at the same time as Magento attributes
• Price attributes have a new name: mage_price_CUSTOMER_GROUP_ID Depending on customer group, the price may vary. Indexer and Search take that into consideration.
• Additional Attributes validation was added. It checks if any Additional Attributes are used by Magento/Doofinder- eg. you cannot add field ‘visibility’ because it is already indexed by Magento
• HashID has to be configured for every store from now on. Changes related to Allow StoreView without HashID has been rolled back.
• MySQL was removed from the indexing/searching process
• Plugins which ensure compatibility between Magento 2.2 and 2.3 were added
• Support for Magento 2.1 was stopped, also in the file composer.json
• Change of indexer from By Schedule to On Save after first whole reindex was deleted- if we changed API, it wouldn’t be needed
• Updated Delayed Updates logic to use IndexerHandler. In addition, the "disabled" operation has been removed when turning off the product because search and indexer is based on attribute values
• Whole search engine works on our code

Refactor Doofinder Attributes

• Change serializer from phpserializer to json
• Remove configuration for default Doofinder fields, leave for couple of them
• Remove "label" field from Additional Attributes
• Add attributes provider for Image link field