Introduction
Many developers make the mistake of creating a heavy custom React block every time a client asks for a styled button, card, or quote box.
Building custom blocks requires npm build pipelines, React maintenance, and potential future deprecation issues as WordPress core evolves.
In 80% of cases, you do not need a custom block; you simply need a Custom Block Style.
register_block_style lets you add elegant, one-click visual options to existing core blocks using clean CSS.

How Block Styles Work for Content Editors
When an editor selects a block (like core/button or core/quote), the sidebar shows a 'Styles' panel with visual thumbnail previews.
Clicking a custom style (e.g. 'Pill Outline', 'Glassmorphism Card', or 'Feature Stat') adds an automated class like is-style-pill-outline to the block wrapper.
The editor sees the live design preview instantly in the canvas with zero confusion.
It delivers intuitive custom design options with zero layout breakage risk.
Registering Block Styles via PHP or theme.json
You can register block styles directly in functions.php with register_block_style('core/button', array('name' => 'glow-accent', 'label' => 'Glowing Accent')).
Even better: in modern block themes, you can declare block styles directly inside theme.json under styles.blocks.
Enqueue dedicated styling only when that block appears on the page using wp_enqueue_block_style().
Browsers download the CSS only on pages where that specific styled block is rendered, keeping global stylesheets featherlight.
Best Use Cases for Custom Block Styles
core/button: Add outline, magnetic shadow, or animated gradient variants.
core/list: Convert standard bullet lists into checkmark benefit lists or numbered steps.
core/group: Add frosted glass, bordered card, or accented highlight background styles.
core/image: Add browser window mockups, Polaroid frames, or subtle parallax shadow borders.
Frequently Asked Questions
Do block styles require compiling React code?: Not at all. Block styles are pure CSS classes attached to core WordPress blocks.
Can an editor select multiple block styles on one block?: By default, a block can have one active style class; use block classes in Advanced settings if stacking multiple utilities.
How do I unregister core styles I don't want editors to use?: Use unregister_block_style() in JavaScript on domReady to remove messy default styles.