Skip to content

The image dimensions have been removed from the name. #82828

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
iiibrapn wants to merge 1 commit into
base: trunk
Choose a base branch
from
+5 −5
Open

The image dimensions have been removed from the name. #82828

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/explanations/user-interface/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

The block editor’s general layout uses a bar at the top, with content below.

![Editor Interface](https://cldup.com/VWA_jMcIRw-3000x3000.png)
![Editor Interface](https://github.com/user-attachments/assets/8a22827b-7e9d-4999-9de0-d21b7c90c659)

@ramonjd ramonjd Sep 14, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wondering if we should still use cldup to host.

What are the rules are about user-updated assets in Github?

@t-hamano t-hamano Sep 14, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This README is published as part of the Block Editor Handbook. Therefore, based on this rule, I believe the media should be uploaded to the developer.wordpress.org Media Library.

@ramonjd ramonjd Sep 14, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah thanks for spotting that.

I've asked in #docs. I've downloaded the images so will pass them on once I hear back.

@iiibrapn iiibrapn Sep 15, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That was the only thing that was bothering me – how to upload images. I’ll bear that in mind for the future.


The **Toolbar** contains document-level actions: Editor/Select modes, save status, global actions for undo/redo/insert, the settings toggle, and publish options.

Expand All @@ -20,7 +20,7 @@ By surfacing each section of the document as a manipulatable block, we surface b

A selected block shows a number of contextual actions:

![Block Interface](https://cldup.com/3tQqIncKPB-3000x3000.png)
![Block Interface](https://github.com/user-attachments/assets/d1143abd-76da-4e39-8329-211f1ae446d4)

The block interface has basic actions. The block editor aims for good, common defaults, so users should be able to create a complete document without actually needing the advanced actions in the Settings Sidebar.

Expand All @@ -32,13 +32,13 @@ Blocks can be moved up and down via the **Block Mover** icons. Additional block

An unselected block does not show the block toolbar or any other contextual controls. In effect, an unselected block is a preview of the content itself:

![Unselected Block](https://cldup.com/DH9HZnEgwH-3000x3000.png)
![Unselected Block](https://github.com/user-attachments/assets/73e3ce93-b5e1-4b21-bf07-20ed5c55c22f)

Please note that selection and focus can be different. An image block can be selected while the focus is on the caption field.

## Settings Sidebar

![Settings Sidebar](https://cldup.com/iAqrn6Gc8o-3000x3000.png)
![Settings Sidebar](https://github.com/user-attachments/assets/a6fe8a45-e947-47ca-a130-102fb2c6005c)

The sidebar has two tabs, Document and Block:

Expand All @@ -58,6 +58,6 @@ Actions that could go in the block tab of the sidebar could be:

## Block Library

![Block Library](https://cldup.com/7QoQIoLk-A-3000x3000.png)
![Block Library](https://github.com/user-attachments/assets/100b8924-9e14-482b-ae63-64220aa7e533)

The **Block Library** appears when someone inserts a block, whether via the toolbar, or contextually within the content area. Inside, blocks are organized into expandable sections. The block library’s search bar auto-filters the list of blocks as the user types. Users can choose a block by selecting the **Block Button** or the **Block Name**.
Loading