Full ACF block.json migration matrix: every legacy PHP key mapped and explained
A developer who migrated over 40 ACF blocks across two client themes has published a comprehensive key-by-key mapping from the legacy acf_register_block_type() PHP function to the modern block.json format. ACF's official documentation covers both registration methods separately but does not cross-reference them, forcing developers to manually reconcile differences. The migration involves three types of key changes: renamed keys where snake_case becomes camelCase, relocated keys that move into WordPress core's top-level block.json schema, and orphaned keys that have no direct block.json equivalent. Some settings, such as enqueue_assets and align, require workarounds like splitting assets by load context or defining custom attribute schemas. The matrix also flags several supports properties as undocumented in block.json, advising developers to test them before relying on them in production.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in