How supports work
Features enabled viasupports automatically:
- Add attributes to the block
- Provide UI controls in the editor
- Apply generated properties to the block wrapper
useBlockProps in JavaScript or get_block_wrapper_attributes() in PHP.
JavaScript
PHP
Available supports
align
Type:boolean | string[]Default:
false
Enables alignment controls. Options: left, center, right, wide, full
anchor
Type:booleanDefault:
false
Adds a field to define an HTML anchor ID for the block.
color
Type:objectDefault:
null
Enables color controls.
color.background
Type:booleanDefault:
true (when color is enabled)
color.text
Type:booleanDefault:
true (when color is enabled)
color.gradients
Type:booleanDefault:
false
color.link
Type:booleanDefault:
false
color.button
Type:booleanDefault:
falseSince: WordPress 6.5
color.heading
Type:booleanDefault:
falseSince: WordPress 6.5
spacing
Type:objectDefault:
null
Enables spacing controls for margin, padding, and block gap.
typography
Type:objectDefault:
null
typography.fontSize
Type:booleanDefault:
false
typography.lineHeight
Type:booleanDefault:
false
typography.textAlign
Type:boolean | string[]Default:
falseSince: WordPress 6.6
dimensions
Type:objectDefault:
nullSince: WordPress 6.2 Enables dimension controls.
background
Type:objectDefault:
nullSince: WordPress 6.5
shadow
Type:booleanDefault:
falseSince: WordPress 6.5
position
Type:objectDefault:
nullSince: WordPress 6.2
Sticky position only works for root-level blocks.
filter
Type:objectDefault:
null
filter.duotone
Type:booleanDefault:
false
layout
Type:boolean | objectDefault:
null
Enables layout controls for container blocks.
className
Type:booleanDefault:
true
Adds .wp-block-{name} class to the block wrapper.
customClassName
Type:booleanDefault:
true
Adds a field for users to define a custom className.
html
Type:booleanDefault:
true
Allows editing the block’s HTML markup.
inserter
Type:booleanDefault:
true
Shows the block in the Inserter.
multiple
Type:booleanDefault:
true
Allows inserting the block multiple times.
reusable
Type:booleanDefault:
true
Allows converting the block to a reusable block.
lock
Type:booleanDefault:
true
Allows locking/unlocking the block.
renaming
Type:booleanDefault:
trueSince: WordPress 6.5 Allows renaming the block.
visibility
Type:booleanDefault:
trueSince: WordPress 6.9 Allows hiding the block.
interactivity
Type:boolean | objectDefault:
false
Indicates Interactivity API usage.
autoRegister
Type:booleanDefault:
false
Enables PHP-only blocks to auto-register in the editor.
listView
Type:booleanDefault:
falseSince: WordPress 7.0 Enables List View panel in the block inspector.