Snopix adds reverse-image search to your WordPress site. Visitors drop an
image onto the search widget and the plugin returns the most visually similar
images already in your media library – ranked by a composite score that looks
at overall structure, colour palette, and edge patterns all at once.

The same fingerprints power a Duplicates tab in the admin: it clusters
near-identical attachments so you can keep one copy and bulk-delete the rest.

Frontend search widget

Place a search widget on any page using the [snopix_search] shortcode.

Default card layout – framed widget, good for a standalone search page:
[snopix_search]

Inline layout – borderless, flows naturally with your page content:
[snopix_search variant=”inline”]

Narrow layout – compact single column, fits a sidebar or tight layout:
[snopix_search variant=”narrow” max_results=”6″]

Custom title and more results:
[snopix_search title=”Find similar products” max_results=”24″]

Card with a custom prompt and result cap:
[snopix_search variant=”card” title=”Reverse Image Search” max_results=”16″]

Optional attributes:

variant – card (default), inline, or narrow.
title – header label shown above the drop zone. Default: “Search by image”. Ignored by the inline variant.
max_results – number of result images to show. Accepts 1-48. Default: 12.

The block editor also exposes these options via a Snopix Search panel on
the core Shortcode block, so you can configure the widget without typing
the shortcode manually.

By default the search endpoint is open to all visitors. Restrict it to
logged-in users only from the Settings tab in Media Snopix.

Admin search

The dashboard includes a drag-and-drop search panel that lets admins test
reverse-image search directly from the media library page without publishing a
shortcode anywhere.

Duplicate detection

The Duplicates tab scans your indexed images against each other and groups
near-identical files. Each group shows the images side by side with a “keep”
selector. Delete all duplicates in a group with one click, or use the global
Delete all duplicates button to clean everything at once.

Background indexing

New uploads are fingerprinted automatically on save. Existing images are
indexed in the background via WP-Cron in batches, so large libraries
(10 000+ images) can be indexed without hitting PHP time limits.

Features

Frontend reverse-image search via [snopix_search] shortcode (card, inline, and narrow variants).
Block-editor shortcode panel for configuring the widget visually.
Admin dashboard search dropzone for quick manual testing.
Duplicate detection with per-group keep selection and bulk delete.
Automatic indexing of new uploads; background bulk indexing for existing images.
REST API at /wp-json/snopix/v1/ with rate limiting on the public search endpoint.
Settings: search visibility, rate limit, match and duplicate thresholds, indexer batch size, probe downscale ceiling.
Tools panel: reindex everything, clear the index, delete orphan rows, flush caches.
Clean uninstall with option to keep or drop all data.

Supported image formats

JPEG, PNG, GIF, WebP, BMP.

Where data lives

Snopix creates one custom table ({prefix}snopix_index) with one row per
indexed image. Uninstalling the plugin drops the table unless you turn off
Drop data on uninstall in the Settings tab.

Accuracy notice

Snopix is functional, but search ranking, duplicate detection and the
threshold tuning may be less accurate than expected. You may see occasional
false positives or miss visually-similar images depending on your media
library. Please report anything that looks off.