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.