Snopix

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.