Topics

On this page

Last updated on Apr 14, 2025

Designing the Editorial Experience

As a designer, you may (and should) also be responsible for designing the editorial experience, not just the end-user experience.

A well-designed editorial experience empowers content creators while maintaining design consistency. When designing blocks and patterns, consider both aesthetics and usability from the editor’s perspective.

Visual Feedback

For editors, visual feedback helps with writing content and creating pages. It is important to ensure editors can easily understand how a block works and possible interactions.

Block boundaries

In the block editor, every block should highlight the boundary. It helps with differentiating the block from other blocks and aids the content creation and designing process.

Figure 4.1 shows how a single column inside a columns block is highlighted when focused. 

Block boundaries
Figure 4.1

Available block variations

Blocks may have different variations and these can be shown differently. Figure 4.2 shows the different variations available for the ‘columns’ block. As you can see, it is a wizard user interface.

Block Variations
Figure 4.2

You can also use the block toolbar to show variations. Figure 4.3 shows the group block and the three different width variations in the toolbar.

width variations in WordPress Block editor
Figure 4.3

Layout control handles

For blocks that have interactions such as resizing, it is important to have well-defined handles.

Figure 4.4 shows the image block with resize handles.

Block Layout controls
Figure 4.4

Spacing visualization

Although spacing is almost always transparent. To effectively create layouts, it is important to differentiate between various spacing types (spacer, padding, margin, etc.).

Figure 4.5 shows the group block with padding (highlighted in blue).

Spacing visualization
Figure 4.5

Block Settings

Blocks have a variety of settings. There are usually two ways to show settings: Inspect Sidebar and Toolbar (Figure 4.6).  

Block Settings
Figure 4.6

Your blocks should be designed to expose the most relevant controls in the most effective manner.

Keep frequently used settings in the toolbar

The most commonly used settings should be immediately accessible to the user:

Some primary controls which should be in the toolbar are (but not limited to):

You may move settings to the sidebar panel if:

It is possible to keep settings in the toolbar as well as the sidebar.

Group related settings to reduce cognitive load:

Typography Controls:

Layout Controls:

Color Controls:

Provide clear, concise labels

Providing clear and concise labels is important to avoid confusion. Labels should be:

Some examples of how you should label settings:

Limit options

The more options available to a person, the longer it will take to decide which option is best (Hick’s law). It is important to limit options to prevent overwhelm.

Essential vs Optional

Figure 4.7 shows how progressive disclosure is utilized for content width settings.

Content width settings
Figure 4.7

Contextual Display

Maximum Counts:

Maintaining WordPress Design Language

WordPress has a distinct and well-documented design system. Using WordPress’ design system ensures that users feel comfortable with the editorial UI you design.

You may refer to the WordPress Design System Figma for more information.


Credits

Authored by Danish Danish Danish Shakeel Senior Software Engineer