Description
VSW – Search Products by Image for WooCommerce lets shoppers find products using a photo instead of typing a product name. Add an image search form to your WooCommerce store so visitors can upload a picture, select the relevant area, and discover visually similar products from your indexed catalogue.
Search WooCommerce products by image
Customers can drag and drop a product photo, choose an image from their device, or use a supported mobile camera. The preview and crop editor help shoppers focus on the item they want. Supported uploads include JPG, PNG, and WebP images up to 5 MB.
Match featured, gallery, and variation images
Catalogue indexing includes product featured images, gallery photos, and variation images. Visual similarity results help customers explore related colours, textures, patterns, and product appearances. Matching quality depends on the uploaded photo and the images available in your catalogue; results are suggestions rather than guaranteed exact matches.
Filters and storefront customisation
Offer category, maximum-price, stock, and global product-attribute filters. Configure the accent colour, desktop grid columns, product image shape, and similarity labels. Enable a floating image-search launcher or choose full, compact, and minimal form presets.
Shortcodes, Gutenberg, and Elementor
Place [vswvisef_visual_search] on a page, insert the Gutenberg block, or use the Elementor widget. For a smaller layout, use [vswvisef_visual_search_preset preset="compact"]. For a minimal form without a category selector, use [vswvisef_visual_search_preset preset="minimal" category="no"].
Catalogue management and search analytics
The first catalogue index starts after setup and account connection. Administrators control subsequent indexing, with category selection, background batches, progress reporting, pause and resume controls, and failed-product retries. Review recent indexing activity, search counts, result clicks, and response times. Export available analytics as 30-day, 90-day, or 365-day CSV reports. A configurable short-lived cache can reuse identical searches.
Hosted service and subscriptions
A connected Visual Search Cloud account is required for image processing and catalogue matching. Hosted-service plans set product and monthly-search allowances. The plugin includes its storefront and administration features without a separate Pro add-on. Freemius provides subscription checkout and account management; review the current price and billing period at checkout. See the External service section for data processing details.
Useful for visually browsed catalogues
Image-based product discovery can help stores selling tiles, flooring, furniture, home decor, clothing, jewellery, and other products customers recognise by appearance. The form works on desktop and mobile browsers.
Created by Awais Awan.
Features include:
- Drag-and-drop and mobile-camera image upload.
- Browser-based image cropping.
- Featured, gallery, and variation-image indexing.
- Category, price, stock, and global product-attribute filters.
- Shortcode and Gutenberg block.
- One-time setup indexing and administrator-controlled catalogue reindexing.
- Privacy-safe aggregate search and click analytics.
- Configurable colours, grid columns, image ratios, and result labels.
- Floating storefront image-search launcher.
- Full, compact, and minimal search-form presets.
- Elementor widget and privacy-safe analytics CSV exports.
Use [vswvisef_visual_search] on any page or add the VSW – Visual Search block.
The service receives:
- Product image bytes, product and variation IDs, names, URLs, prices, stock status, and category names during indexing.
- The shopper’s uploaded or cropped image, selected category, requested result limit, and search settings during a search.
- Product and variation IDs when a shopper clicks a result, for aggregate analytics.
The included Laravel service processes images in memory and stores numerical visual descriptors for indexed product images. It does not retain shopper-uploaded images, shopper filenames, or shopper IP addresses in analytics. WordPress temporarily stores a one-way hash derived from the shopper IP for five-minute abuse-rate limiting.
The service is operated by Awais Awan. Store administrators who self-host the included Laravel service are the service operator for their installation.
Source code for the plugin is included in this release package under source/assets/. The readable JavaScript and CSS files in that directory are the source for the distributed files in assets/. The distributed files are intentionally kept free of third-party dependencies; no external JavaScript or CSS library is bundled.
Development and build
The plugin has no dependency installation step. Edit the human-readable files in source/assets/, then copy the corresponding files to assets/ for a release. The distributed files are intentionally kept free of third-party dependencies.
Privacy
Store owners should disclose that product images and customer-selected search images are sent to their configured visual-search service. The plugin does not add third-party advertising or tracking scripts. Search-result click tracking is limited to product IDs and a random search identifier.
Installation
- Install and activate WooCommerce.
- Upload and activate VSW – Visual Search for WooCommerce.
- Open WooCommerce > Visual Search.
- Connect your hosted visual-search account.
- Wait for the first catalogue index to complete.
- Add
[vswvisef_visual_search]to a page or insert the VSW – Visual Search block.
FAQ
Does the plugin store customer search images?
No. The included Laravel service processes customer images in memory. It stores aggregate search status, response duration, result counts, categories, product clicks, and failure reasons, but not uploaded images, filenames, or IP addresses.
Does the plugin require an external account?
Yes. Connect the plugin to your VSW – Visual Search SaaS account. Subscription plans control hosted catalogue and monthly-search limits.
Does it index gallery and variation images?
Yes. Each product is ranked using its strongest featured, gallery, variation, or local-region match.
What image types can shoppers upload?
JPG, PNG, and WebP images up to 5 MB.
Do I need a separate Pro add-on?
No. Floating search, presets, Elementor integration, custom labels, and analytics exports are included in this plugin. SaaS usage is controlled by the selected subscription plan.
Screenshots
Changelog
2.0.8
- Fixed clipped storefront result buttons and improved result layout compatibility.
- Improved admin tab styling and added a Contact Us tab.
- Updated the Free plan display to 200 products and 200 monthly searches.
- Added an upgrade link when usage reaches the service allowance.
2.0.5
- Renamed plugin-owned identifiers with the distinct
vswvisefprefix, added legacy option migration, and included readable asset sources for WordPress.org review.
2.0.4
- Clarified the hosted-service model and added direct service Terms and Privacy Policy links for WordPress.org review.
2.0.3
- Added complete author metadata and completed the WordPress.org release-package audit.
2.0.2
- Resolved Plugin Check security, internationalization, hook-prefix, filesystem, and metadata findings.
2.0.1
- Improved spacing, labels, and responsive layout for custom-label and floating-search settings.
2.0.0
- Consolidated every former Pro add-on feature into the main plugin; SaaS subscriptions are now the only paid layer.
1.10.0
- Removed recurring catalogue sync and product-save indexing; indexing now starts once during setup or manually.
1.9.0
- Added a clear plan comparison and usage-based subscription recommendation.
1.8.0
- Simplified onboarding with a built-in hosted service URL and a polished connection workflow.
1.7.1
- Display the correct PayPal sandbox or live-payment status in WooCommerce settings.
1.7.0
- Replaced Stripe controls with secure PayPal subscription approval and cancellation.
1.6.2
- Prepared the free plugin package and service/privacy documentation for WordPress.org review.
1.6.1
- Added unique crop-dialog identifiers for pages containing multiple search forms.









