Promote repeated content into a synced block

ContentAdvanced~25 min

Before you start

A connected site with content reads on and the block create and post update write abilities enabled for the write pass. The agent needs edit access to the pages it changes.

At some point the same block of content, a signup callout, a disclaimer, a promo strip, gets pasted into a dozen pages by hand. Then the wording changes, and now you are hunting for every copy and fixing each one, missing three. A synced block solves it: edit once, and every page that references it updates together. The catch is the migration, moving all those hand-pasted copies onto the one block.

This does that migration for you. It finds the copies, makes the single block, and swaps each page over once you approve the plan.

The prompt
The same [signup callout] is pasted by hand into a bunch of my landing pages and
every copy has drifted. I want it turned into one synced block and rolled out so I
only maintain it in one place.
Work read-first. Search my pages for the ones that contain [the callout] and show
me the list. Check the existing synced blocks so we do not make a duplicate. Read
one page that has a clean copy and show me the exact markup you would save as the
new synced block.
Wait for my go. Once I approve the block, create it, then update each page in
small batches to swap its pasted copy for a reference to the synced block, and
show me each batch before it saves. Do not touch anything else on the page. List
every page you changed. Each edit keeps a revision, so we can roll any page back
if a swap looks wrong.

Why this is safe to run

The planning pass is reads. Searching for the pages, listing the synced blocks you already have, and reading a clean copy of the snippet all write nothing, so you approve both the exact block markup and the list of pages before anything is created or changed.

The write half happens in two clearly separated moves you control: creating the one synced block, then swapping each page’s inline copy for a reference to it. Nothing else on a page is touched, and because every page edit is saved as a WordPress revision, any page can be rolled back to how it was. The create and update abilities stay off until you enable them, every call is checked against the capability of the user you bound the agent to, and every write lands in the Activity Log with the page it changed.

Already connected? You do not have to paste this. Ask your agent for the “promote repeated content into a synced block” recipe, or just describe the snippet you keep pasting everywhere, and it runs the same read-first flow on your own site.

How it works

  1. Search your pages for the ones that contain the repeated snippet and list them.
  2. Check the existing synced blocks so the recipe does not make a duplicate.
  3. Read one clean copy of the snippet and show the exact markup it would save as the new synced block.
  4. Wait for your approval, then create the synced block.
  5. Update each page in small batches to swap its pasted copy for a reference to the block, pausing to show each batch.
  6. List every page it changed so you can review it, with each edit kept as a revision.

Questions

What happens to the pasted copy already on each page?
Each page swap replaces that pasted copy with a reference to the new synced block and leaves the rest of the page alone. Because every edit is saved as a revision, any page can be rolled back.
Will it make a duplicate block if one already exists?
No. The recipe lists the existing synced blocks first and shows you what it found, so you can point it at a block you already have instead of creating a second one.