Block Style

[porg]

What is the new page you are requesting?

• Term: "Block Style" → The end user documentation contains neither a standalone article nor a chapter in one of the adequate articles.

How will this new page help you?

• A definition what a block style is.
• For end users: How to use block styles shipped with a block plugin or theme.
• For those interested in block theme creation/tweaking: Background info what a block style technically is and where it is coming from.

If integrated in existing articles

I'd expect it here mostly:

• https://wordpress.org/documentation/article/work-with-blocks/

This article documents how global styles work (which have their own side panel):

• https://wordpress.org/documentation/article/styles-overview/#how-styles-works

AFAIK I would describe a "Block Style" like this:

A block style is a preset which holds a bundle of block attributes and their values, which you can apply to the currently selected block, by opening Block Settings → section "Styles" → clicking your desired style. E.g. for a button block the available styles in the Twenty Twenty Three theme are "Default" and "Outline".

Technical background information: A block style is a convenience function in the Block Editor GUI. You could achieve the same by going to the section "Advanced" and under "ADDITIONAL CSS CLASS(ES)" and add the corresponding classname, e.g. .is-style-outline for the "Outline" style.

The block style is defined in the theme's theme.json or the block's block.json

[zzap]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.