⚡ NEW: WordPress/gutenberg/issues/ - Uncensored 2025

Skip to content

Moving background tools for the Cover block from the Block Inspector to the Toolbar + extending background tools to Cover/Group blocks #28643

@critterverse

Description

@critterverse

Hi all, here's a proposal to extend the background functionalities of Cover blocks to other types of “container” blocks. It has two parts —

  • Making changes to the Cover block
  • Extending those changes to other container blocks (Group and Column for now, but these changes could apply to Navigation or other blocks in the future)

Goals

Move background tools into the toolbar

  • This will ensure that all primary functionality is accessible from the toolbar
  • This change also starts to reduce the number of panels needed in the Block Inspector, clearing room for more robust and universal block controls like those outlined by @mtias in #27331

Clear up the existing confusion users have about how their media is displayed within the Cover block, particularly in terms of the aspect ratio of the Cover block vs. the aspect ratio of their uploaded image/video.

Close some existing issues

  • #20837 — Cover: Move color controls to the toolbar
  • #24660 — Allow using featured image as background for a group block

Part 1 - Cover block

Proposal: Remove the Media Settings panel that’s currently displayed in the Block Inspector and add a new section to the Block Toolbar with popover menus for Media, Color, and Add/Replace Media.

cover-background-tools.mov

Media popover menu:

The Media popover menu contains 4 sections: Focal point, Display, Fixed Background, and Remove media. The top focal point section is very similar to the focal picker that’s current displayed in the Block Inspector for a Cover block. It has an image preview and input boxes below to specify the horizontal and vertical focus position. The main difference with this focus picker is that there is a border that shows the area of the image that will be visible in the Cover block based on the current focal point. There’s also a toggle to the right of the input forms with icons for Desktop and Mobile. The user can toggle between these two views to see how the boundary area of the focal picker changes in the preview above. Below the focal point section, there is a Display dropdown selector menu with 3 options — Fill, Fit, and Repeat. Below that is a toggle to turn Fixed background on or off. The bottom section of the popover menu is separated from the other Media options with a black line above it. It says “Remove media” and uses a trash can icon.

Color popover menu:

The Color popover menu contains 3 sections: Color swatches, Opacity, and Remove color. The swatches section at the top of the menu is an exact mirror of the way colors are current displayed in the Overlay panel in the Block Inspector for the Cover block, including the toggle to switch between Solid and Gradient color swatches. Below that is an Opacity section containing a slider and an input form to numerically enter an opacity value. The bottom section of the popover menu is separated from the other Media options with a black line above it. It says “Remove media” and uses a trash can icon.

Add/replace media popover menu:

The Add Media menu is a simple list popover containing 3 items with corresponding icons: Open Media Library, Upload, and Use Featured Image.

Part 2 - Group/Column blocks

The new section of the Toolbar could also be added to Group and Container blocks.

Empty Group block:

Now including the new background section in the toolbar

Group block with media background:

Now including the new background section in the toolbar

Empty Column block:

Now including the new background section in the toolbar

Column block with media background:

Now including the new background section in the toolbar

Note: These comps also include the addition of the “toggle full-height” option in the toolbar for Group/Cover blocks.

What about the Block Inspector?

Current color options for Cover block vs. Group/Column blocks in the Block Inspector:

side-by-side comparison with screenshots of the Block Inspector for the Cover block on the left and the Group block on the right

In the future, a universal color panel that can handle color for multiple layers (#27331) would be a great way to unify the Inspector options for the different types of Container blocks.

There may be some steps we can take in the meantime to make the difference between color options for Cover and Group/Column less confusing. For example:

  • Remove the Overlay panel that currently appears as an option for the Cover block and replace it with the Color Settings panel that appears for Group/Column blocks (or vice versa)
  • Potentially look at changing any section titles that use “Background Color” to “Overlay Color” when media is in use

Metadata

Metadata

Assignees

No one assigned

    Labels

    Needs Design FeedbackNeeds general design feedback.[Block] ColumnsAffects the Columns Block[Block] CoverAffects the Cover Block - used to display content laid over a background image[Block] GroupAffects the Group Block (and row, stack and grid variants)[Feature] Design ToolsTools that impact the appearance of blocks both to expand the number of tools and improve the experi[Focus] Accessibility (a11y)Changes that impact accessibility and need corresponding review (e.g. markup changes).

    Type

    No type

    Projects

    Status

    ✅ Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions