Panel Registry: Save, Re-register, and Sync

Understanding the difference between saving the registry and re-registering blocks prevents confusion when changes do not seem to take effect.

Saving the Registry

Admin: Custom Blocks → Panel Registry → Save

Saving updates the registry definitions stored in wp_options. This is the list of available options, for example, changing the heading level choices from h1–h6 to h1–h4 only.

Saving does not automatically update any block. Blocks that are already registered with WordPress still have their old attribute definitions until you re-register them.

Re-registering a Block

Admin: Custom Blocks → Block Audit → Re-register

Re-registration reads the current registry and updates the block’s attribute definitions in WordPress. After re-registration, the block’s inspector shows the new options. The Block Audit table shows ✓ registry pills for panels that are synced.

Use Sync All Blocks to re-register every installed block at once.

When to Re-register

You must re-register after:

• Adding or removing options in the Panel Registry
• Changing the default value for a panel field
• Uploading a new version of a block that changes its wptPanels declaration

You do not need to re-register after:

• Editing block content (text, images) on a page
• Changing design token values (colours, spacing) in Brand Settings
• Editing the block’s style.css or render.php without changing attributes