WP Manifestindependent plugin directory
manifest / admin / acf-aware-search-replace-plugin

ACF-Aware Search & Replace

Safe, serialization-aware search/replace across posts, postmeta (incl. ACF), and options (incl. ACF Options). Shows counts and per-page results. Includes WP-CLI.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/shandyw/acf-aware-search-replace-plugin/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Safe, serialization-aware search/replace across posts, ACF fields, and options with counts, CSV export, batching, and WP-CLI.

screenshot

Features

  • Serialization-aware — safely replaces inside ACF repeaters, flexible content, and other serialized fields.
  • Dry-run mode — scan before replacing anything.
  • Detailed results — see counts, snippets, and affected fields.
  • CSV export — download results for review or archiving.
  • Batching/pagination — scan or replace massive sites in smaller chunks.
  • WP-CLI support — run replacements from the command line.

Installation

  1. Upload the plugin folder to /wp-content/plugins/.
  2. Activate ACF-Aware Search & Replace from Plugins in WordPress.
  3. Go to Tools → ACF Search/Replace.

Usage

Admin UI

  • Enter the text to search for.
  • Optionally enter replacement text (leave blank for a dry-run).
  • Choose whether to scan posts, postmeta, and/or options.
  • Review results with counts, snippets, and links.
  • Export results to CSV or perform replacements.

WP-CLI

# Dry-run only
wp acfsr "oldtext" --dry-run

# Replace across DB
wp acfsr "oldtext" --replace="newtext"

# Export matches to CSV
wp acfsr "domain.com" --dry-run --export="/tmp/results.csv"