Search & Replace (Blocks)

Search & Replace runs a site-wide find-and-replace across your content — ideal for a changed URL, a renamed product, a swapped brand colour or a repeated typo — with a safe preview before anything is written.

Where: WP Admin → Tiger Blocks → Tools → Search & Replace. Enable it under Modules & Widgets → Search & Replace.

Run it safely

1. Choose a mode, enter your search and replace values, and optionally limit the scan to certain post types.
2. Click Preview. Nothing is written — you get a list of every match with a before/after snippet, each row individually selectable.
3. Review, untick anything you want to skip, then Replace to commit only the ticked items.

Five replacement modes

• Text — the default. Replaces plain strings in post_content, post_title and post_excerpt, and also walks each post’s parsed block tree for plain-text attribute values. It deliberately skips strings that look like a colour or a URL so text edits never corrupt links or styles.
• Colour — matches hex/rgb/rgba/hsl/hsla values by their normalised form (so #fff equals #ffffff) and swaps them in the block attributes.
• Link — replaces URL substrings inside link/URL attributes (for example a button’s target), without touching image media.
• Image — rewrites the url of Gutenberg media attributes while leaving the attachment id intact.
• Font — changes fontFamily values only (a theme.json slug or a raw CSS family), never arbitrary text.

The colour, link, image and font modes are structure-aware: they edit the parsed block attribute tree (via parse_blocks()/serialize_blocks()) and never raw markup strings, so they cannot break your layouts.

Scope & limits

Options include case-sensitive and whole-word matching, and a post-type filter. Each run scans up to 5,000 posts and returns up to 400 preview rows; larger sites are flagged as truncated so you can narrow the scope. Only administrators can run the tool, and every call is nonce-checked.

Troubleshooting

My colour or font replacement found nothing, but the value is clearly on the page

The structure-aware modes only scan block content (posts that contain <!-- wp: --> markup). Classic-editor content and values injected by a theme or CSS file are out of scope. For a plain string that lives in HTML, use Text mode instead.

Is a committed replacement reversible?

No — a committed replace writes straight to the database. Always run the Preview first, and take a full database backup before a large change so you can roll back if needed.