We use necessary cookies to make this site work. With your permission we also use Google Analytics to understand how the site is used and Google Ads cookies to measure which of our ads lead to purchases. You can accept all cookies, reject the optional ones or choose which ones to allow. Cookie policy
Choose which cookies you allow. Necessary cookies are always on because the shop cannot work without them. You can change your choice at any time with the "Cookie settings" link.
Needed for the basket, checkout, login and security. They do not track you.
Google Analytics: how many people visit, which pages they read and how they found the site. It sets the _ga cookies and sends usage data to Google.
Google Ads: measures which of our ads lead to a purchase. It sets the cookies _gcl_au and _gcl_aw (90 days) and, when you buy, sends Google the order details and a hashed form of your contact details for matching. See our cookie and privacy policies.
Magento shop by look and AI visual search: shoppers search from a photo, find visually similar products and explore shoppable looks. Build product hotspots by hand or review AI suggestions before publishing. Luma and Hyvä, with catalogue indexing and provider cost controls.
One-off payment, with 12 months of updates.
No subscription or automatic renewal. Keep using the versions included in your update period. Update and licence details
Composer package commercegears/module-ai-visual-search
Some shoppers know the look they want but cannot name it. AI Visual Search & Shop the Look gives them a photo-based route into your range, alternatives from a product they already like and curated scenes linked to actual catalogue items.
The storefront camera control accepts a supported photo from the camera or library. Similar-products mode compares it with indexed catalogue images and displays matches through your product cards. Category controls refine the selection without sending the photo again.
Find similar and the Visually similar product section offer another route, using existing catalogue vectors. Check real product suitability: colour and silhouette alone do not establish the same size, material or technical compatibility.
Create a scene and add numbered product hotspots manually, or use Detect Items with AI to propose objects and catalogue matches. Confirm, swap or remove suggestions before they are shown publicly. Assign store views and insert the Shop the Look CMS widget; looks can also appear on related product pages.
Individual product controls let customers choose what to buy. Add all to cart adds supported items without required options; a sized or configurable product links to its page rather than guessing the customer's selection.
Customer-photo Shop the look is a separate mode: a vision model identifies items in the uploaded scene and presents matching catalogue candidates for each. Evaluate cluttered scenes separately from clean single-object photos.
Index the base image, small image or up to four gallery images per product. Status & Index shows coverage, queue, vector backend and a cost estimate. Changed images are re-embedded. The anonymous search log records result counts, first clicks and provider/budget problems.
Use similarity thresholds, visitor and website limits and AI Core budgets. Results depend on clear catalogue photography; indexing more poor images does not guarantee better matches.
Magento Open Source or Adobe Commerce 2.4.7–2.4.9, PHP 8.2–8.5 with the documented image extensions, CommerceGears Core and AI Core. Luma and Hyvä are supported. Voyage AI provides image embeddings; item detection also needs a supported Anthropic or OpenAI vision model.
Uploaded photos are processed by those providers. EXIF is removed and images are re-encoded; local disk retention is normally off but can be enabled for troubleshooting. HEIC depends on browser conversion; JPEG, PNG and WebP are the documented formats.
Read the Visual Search and Shop the Look guide and test one photo, one similar-product journey and one reviewed look before launch.
Try the admin demo. Storefront examples are available on the Luma demo and Hyvä demo. Demonstration or offline-test data shows the workflow; evaluate AI matching and forecasts with your own representative catalogue.
It returns visual matches, not guaranteed identity or technical compatibility. Materials, dimensions and suitability still need the product information.
No. Item detection proposes matches and your team confirms, replaces or removes them before merchant-look suggestions are shown to shoppers.
No. Products requiring options open their product pages. The combined action adds supported products that do not need options.
Voyage AI for image embeddings. AI item detection also requires a supported Anthropic or OpenAI vision model through AI Core.
Not normally. The module strips EXIF and re-encodes images, and sends them to configured providers for processing. Optional troubleshooting retention changes local storage behaviour.
Shoppers take or choose a photo and get matching products from your catalogue, with category buttons to filter the results without sending the photo again.
Place a look with hotspots on any CMS page or block. It also appears on the product pages of the products in it, with Add to cart per item and Add all to cart.
The photo is not stored and the search log has no photo, IP address or customer. Limits per visitor and per day and the AI budgets keep costs under control.
All features
Live demo
A full Magento store with the module installed, on Luma and on Hyvä. The admin demo signs you in with one click.
Compatibility
| Magento | 2.4.6 – 2.4.9 |
|---|---|
| Platforms | Magento Open Source and Adobe Commerce (one price) |
| Storefront themes | Luma Blank Hyvä |
| PHP | 8.2 – 8.5 |
| Latest version | 2.1.4 |
| composer.json requires | php ~8.2.0||~8.3.0||~8.4.0||~8.5.0 ext-gd * ext-fileinfo * ext-json * magento/framework ~103.0.6 commercegears/module-core ^2.0 free, installed by Composer with this module commercegears/module-ai-core ^2.0 free, installed by Composer with this module magento/module-backend * magento/module-catalog * magento/module-catalog-inventory * magento/module-checkout * magento/module-cms * magento/module-config * magento/module-customer * magento/module-store * magento/module-ui * magento/module-widget * |
Installation
After you buy, create a Composer key in your account. Then, in the root of your Magento project:
01Add the repository and your key (once per project)
composer config repositories.commercegears composer https://repo.commercegears.com composer config --auth http-basic.repo.commercegears.com PUBLIC_KEY PRIVATE_KEY
02Install the module
composer require commercegears/module-ai-visual-search
03Enable it
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy bin/magento cache:flush
The last three are only needed in production mode.
Prefer a zip? Every version you are entitled to can be downloaded from My modules. More about Composer access
User guide
The user guide has its own page: how to install Magento Shop by Look & AI Visual Search, what each option does and how to use it in your store. Written for version 2.1.4; a copy ships with the module.
Changelog
FAQ
Something else on your mind? The developers who wrote the module answer before and after you buy.
Ask a question →Already installed it? Open a support ticket
A Voyage AI key, entered in CommerceGears AI Core under AI Providers & Costs: product images and shoppers' photos are embedded with Voyage AI. For "Detect Items with AI" and "Shop the look" with customer photos you also need an Anthropic or OpenAI key with a vision-capable model. AI Core is installed with the module.
"Estimate Cost" on the Status & Index page shows the cost before anything is sent, usually a few pence per 1,000 products. An image is embedded again only when it changes. You can set a monthly budget for all AI modules in AI Providers & Costs, and a limit for this module.
No. The photo is validated, re-encoded (location data removed) and not written to disk unless you switch on keeping uploads for troubleshooting. The search log is anonymous: no photo, IP address or customer is stored.
Photo search shows a polite message, and the search log records the problem. The daily limit and the limit per visitor work the same way.
No. Detect Items with AI only adds suggestions in the look editor. They are never shown to shoppers until you confirm them.
Plain packshots. Lifestyle photos with several products match the dominant one; use Shop the Look for those. Indexing up to 4 gallery images per product helps when shoppers photograph products from other angles.
Yes. On Luma the camera button sits inside the search field, on Hyvä in the header icon bar.
Magento Open Source and Adobe Commerce 2.4.6 to 2.4.9 with PHP 8.2 to 8.5 (Magento 2.4.6: PHP 8.2; GD and fileinfo; exif recommended).
Support
From the blog
Magento's search is better than its reputation, as long as it is set up. How the built-in OpenSearch search works, the settings and free fixes worth an afternoon, where it stops, and what the different kinds of search extensions add.
Most related product blocks are empty or out of date because someone has to fill them product by product. Rules can do the filling; a simple test tells you whether it was worth it.
Let shoppers start with a photo, explore alternatives and shop a curated scene. See how matching, hotspots, review and product options work together.