Skip to content

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

Open
iiibrapn wants to merge 1 commit into
WordPress:trunkfrom
iiibrapn:patch-1
Open

iiibrapn wants to merge 1 commit into
WordPress:trunkfrom
iiibrapn:patch-1

Conversation

@iiibrapn

Copy link
Copy Markdown

What?

Fixes WordPress/wporg-developer#542

This PR replaces the image URLs in the User Interface documentation with clean links that do not specify image dimensions in the file name.

Why?

Currently, the images on the User Interface page are severely distorted (too narrow and extremely tall). The site's parser extracts the -3000x3000 suffix from the original Cloudup image URLs and forces a height="3000px" attribute.

While humankind hasn't yet invented screens tall enough to easily view such images, fixing the URLs is a practical solution to restore the correct proportions.

How?

Re-uploaded the original images directly to GitHub to generate clean user-attachments URLs. By loading images without dimensional suffixes, the front-end parser will stop assigning the hardcoded 3000px height, allowing the images to display correctly.

Testing Instructions

  1. Review the updated README.md file.
  2. Verify that the markdown image URLs no longer contain suffixes like -3000x3000.png.
  3. The visual fix will be observable on developer.wordpress.org once the documentation repository syncs.

Testing Instructions for Keyboard

N/A - Documentation update only.

Screenshots or screencast

Before
Screenshot From 2026-09-13 22-15-16

After
Screenshot From 2026-09-13 22-15-25

Here we can see that the image has inherited a height of 3000px, which is why it has been stretched out of proportion.

…ot specify the aspect ratio in the file name.

Replacing images with fixed aspect ratios with similar ones that do not specify the aspect ratio in the file name.

This resolves the issue WordPress#542 of the page being too narrow and too tall at https://developer.wordpress.org/block-editor/explanations/user-interface/
@github-actions

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @iiibrapn.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Unlinked contributors: iiibrapn.

Co-authored-by: dd32 <dd32@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@github-actions

github-actions Bot commented Sep 13, 2026

Copy link
Copy Markdown

🤖 PR meta 🤖

👋 Welcome

👋 Thanks for your first Pull Request and for helping build the future of Gutenberg and WordPress, @iiibrapn! In case you missed it, we'd love to have you join us in our Slack community.

If you want to learn more about WordPress development in general, check out the Core Handbook full of helpful information.

@github-actions github-actions Bot added the First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository label Sep 13, 2026
@ramonjd ramonjd added the [Type] Developer Documentation Documentation for developers label Sep 14, 2026
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)

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

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.

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

First-time Contributor Pull request opened by a first-time contributor to Gutenberg repository [Type] Developer Documentation Documentation for developers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Stretched images on some imported pages

3 participants