Troubleshooting

“The block doesn’t render”

Start by checking:

  • Is there a PHP parse error?
  • Does the block require ACF fields that aren’t populated?
  • Did the AI generate a query that returns no results?

A fast fix is to run:

  • Lint/parse checks
  • Preview with placeholder content
  • Ask Mode: “Why might this block not render?”

“AI keeps changing more than I asked”

Use tighter prompts:

  • Request one change at a time
  • Reference the exact field/file you want updated
  • If needed, instruct: “Do not modify any other files.”

“Exported block doesn’t work on another site”

Confirm:

  • ACF Pro is installed on the target site
  • Any required post types/taxonomies exist

If you’re exporting to plugin for reuse, keep it self-contained and avoid hard dependencies on site-specific objects unless documented.