Find every mention of a phrase across your whole site

ContentBeginner~5 min

Before you start

The search-content ability turned on for the user you bound the agent to. No writes are involved.

Before you rename a product, retire an old URL, or fix a claim you got wrong, you want to know exactly how many places it shows up. Checking posts, then pages, then products one screen at a time is how you miss the one straggler that keeps the old wording alive. This prompt runs a single search across every post type and hands you the whole list, so you can see the blast radius first. It reads and reports, and it changes nothing.

The prompt
Search my whole site for every place this phrase appears: [old product name].
Read only, change nothing.
Cover every post type in one pass, not just posts. For each hit, give me the
title, the post type, and a short bit of the surrounding text so I can tell
whether it actually needs changing.
Group the results by post type and give me a count, so I can see how big a job
a rename would be before I commit to it.

Why this is safe to run

The one ability behind this is a search. It reads across your content and returns matches, and it has no way to edit, replace, or delete any of them. So running it is purely a way to look, and looking cannot break anything. The value is knowing the scope up front instead of discovering a forgotten mention weeks after a rename.

This pairs naturally with a find-and-replace when you are ready to actually make the change, but that is a separate, deliberate step with its own write ability and its own approval. This recipe stops at the search on purpose. Every call runs against the capability of the user you bound the agent to and lands in the Activity Log.

Already connected? Skip the paste. Ask your agent for the “find every mention across your site” recipe, or just ask where a phrase appears on your site, and it runs the same search on your own install.

How it works

  1. Search every post type in one pass for the phrase you name.
  2. Collect each place it appears with the title and a bit of surrounding context.
  3. Group the hits by post type so pages, posts, and products are easy to tell apart.
  4. Report the full list so you can see the blast radius before you touch anything.

Questions

Does this edit or replace anything it finds?
No. It only searches and reports. It reads across your content and hands you the list of matches, and it writes nothing. If you want to actually change those mentions, that is a separate find-and-replace step you run afterward, deliberately.
Does it search posts and pages, or everything?
One search spans every post type at once, so a single run covers posts, pages, and other content types together instead of you checking each one separately. That is the point: you see every place the phrase lives in a single read.