add-variation

To create a WordPress block variation, use registerBlockVariation to define preset attributes, innerBlocks, and icons. The tool scaffolds the variation files under src/variations/[block-name]-variations and updates index.js for activation.

A WordPress Gutenberg block variation is a pre-configured version of an existing core block with preset attributes, innerBlocks, and icons. You need one to provide reusable block setups without building entirely new blocks from scratch.

The correct folder structure for a Gutenberg block variation requires placing files under src/variations/[block-name]-variations/. You must also add an import in src/index.js to activate the variation within your project wiring.

Yes, you can add preset attributes and innerBlocks to a core block variation. The scaffolding process guides you to specify the core block, variation name, description, default layout, attributes, and icon to generate the configuration.

You need to provide the target core block, the variation name, a description, the default layout and attributes, and an icon. This input generates a ready-to-use variation skeleton with proper project wiring.

Block variations may not appear if the project wiring is incomplete. Ensure the variation is placed under src/variations/[block-name]-variations and that src/index.js contains the required import statement to activate the variation.