WordPress.org

Theme Support Edit

By default, blocks provide their styles to enable basic support for blocks in themes without any change. Themes can add/override these styles, or they can provide no styles at all, and rely fully on what the theme provides.

Some advanced block features require opt-in support in the theme itself as it’s difficult for the block to provide these styles, they may require some architecting of the theme itself, in order to work well.

To opt-in for one of these features, call add_theme_support in the functions.php file of the theme. For example:

function mytheme_setup_theme_supported_features() {
    add_theme_support( 'editor-color-palette',
        '#a156b4',
        '#d0a5db',
        '#eee',
        '#444'
    );
}

add_action( 'after_setup_theme', 'mytheme_setup_theme_supported_features' );

Opt-in features Opt-in features

Wide Alignment: Wide Alignment:

Some blocks such as the image block have the possibility to define a “wide” or “full” alignment by adding the corresponding classname to the block’s wrapper ( alignwide or alignfull ). A theme can opt-in for this feature by calling:

add_theme_support( 'align-wide' );

Top ↑

Block Color Palettes: Block Color Palettes:

Different blocks have the possibility of customizing colors. Gutenberg provides a default palette, but a theme can overwrite it and provide its own:

add_theme_support( 'editor-color-palette',
    '#a156b4',
    '#d0a5db',
    '#eee',
    '#444'
);

The colors will be shown in order on the palette, and there’s no limit to how many can be specified.

Top ↑

Disabling custom colors in block Color Palettes Disabling custom colors in block Color Palettes

By default, the color palette offered to blocks, allows the user to select a custom color different from the editor or theme default colors.
Themes can disable this feature using:

add_theme_support( 'disable-custom-colors' );

This flag will make sure users are only able to choose colors from the editor-color-palette the theme provided or from the editor default colors if the theme did not provide one.