Troubleshooting

The index does not fill. WP-Cron only runs on uncached requests; with most pages served by a page cache, use wp bb-media index or the buttons on the Media index screen.

verify reports differences. Files changed outside WordPress (SFTP, a database or file sync). wp bb-media verify --fix.

A used image is in the unused report. It is referenced somewhere the scan does not look (a hard-coded ID in a template, another site). Add it to a post, field or option, or keep it off the deletion list.

BB Migrate still sends identical files. Both sites need BB Media and hashes (wp bb-media hash), and the hash is only used while the file's size and date match what was hashed: after files changed outside WordPress, run verify --fix, then hash.

Copies are made but not served. BB Cache's "Serve WebP" must be on; the Media index screen must report the copies as image/webp; pages cached before the copies existed are purged when a run ends (or purge BB Cache).

Compression shows "paused". Smush Pro compresses uploads automatically on the site; switch that off to let BB Media take over.