VSW – Visual Search for WooCommerce

VSW – Visual Search adds a responsive image-upload search form to WooCommerce. Customers can upload, preview, and crop a photo, optionally filter the catalogue, and open visually similar products.

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.

External service

This plugin connects to Visual Search Cloud at https://visualsearch.predictsx.com because image feature extraction and catalogue comparison are performed by the hosted service. The store administrator explicitly approves the connection before any catalogue or search data is sent. All features shipped in the GPL plugin remain available; subscriptions pay only for hosted processing, storage, and usage.

Service terms: https://visualsearch.predictsx.com/terms

Service privacy policy: https://visualsearch.predictsx.com/privacy

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.