Skip to content

Conversation

@andrewserong
Copy link
Contributor

@andrewserong andrewserong commented Dec 8, 2025

What?

A first pass at: #72734

🚧 🚧 🚧 Note: this is a little hacky for now, I'm mostly pinging folks for early feedback on the overall direction, and whether it's a good idea to pursue integrating into the editor package 🚧 🚧 🚧

Add a media editor state of the editor with the goal that media items (attachments) can be edited directly from a block-editor-like interface, but in an isolated mode, a bit like editing template parts.

This PR is designed to simply provide the scaffolding to achieve this — it will just display the media item, and a DataForm for the fields associated with the item.

It'll be up to follow-up PRs to implement cropping, saving, properly locking down parts of the editor UI, etc.

Why?

So that folks who wish to edit a media item can do more than just the inline cropping within the block editor, without having to go all the way out of the block editor.

How?

  • Add the recently introduced media fields to the attachment post type in the editor package
  • Create effectively a new mode for the editor, based on if we're editing an attachment post type
  • In this mode, render a MediaMetadataPanel instead of the post panel. There's basically lots of conditionals for this sort of behaviour.

Testing Instructions

Switch on the experiment:

image
  • Go to the post editor and add an image block, with an image.
  • You should be able to click Edit Media in the block toolbar to go to a media editor view.
  • From that view you should be able to see metadata for the media item, and update the title, alt text, caption, and description
  • You can save from that view
  • If you don't save, but go back to the post, you should still have the option of saving when you go to publish the page
  • Repeat the above steps in the site editor

Some caveats / things to improve in follow-ups

  • Routing in the site editor means we have a dedicated route. If we click the W icon while editing a media item, we currently get an empty sidebar. Expanding this would be for follow-up PRs
  • Some of the actions don't work properly for attachment types — these could be tweaked in follow-ups (e.g. remove Duplicate action, and swap out permanently delete for trash, etc)
  • Figure out what to do about the preview dropdown. Previewing at different sizes would be a good idea for the media editor, too! Perhaps we should make the canvas area scalable like it is for the focused editor for template parts, etc. This too could be for a follow-up.
  • There is a flash of unstyled editor when you click Edit Media — I think this is an existing bug, but could be looked at separately

Screenshots or screencast

image
2025-12-10.17.13.07.mp4

@andrewserong andrewserong self-assigned this Dec 8, 2025
@andrewserong andrewserong added [Feature] Media Anything that impacts the experience of managing media [Type] Experimental Experimental feature or API. labels Dec 8, 2025
@github-actions
Copy link

github-actions bot commented Dec 8, 2025

Size Change: +24.9 kB (+0.97%)

Total Size: 2.6 MB

Filename Size Change
build/scripts/block-library/index.min.js 278 kB +23 B (+0.01%)
build/scripts/edit-site/index.min.js 234 kB +104 B (+0.04%)
build/scripts/editor/index.min.js 308 kB +24.4 kB (+8.59%) 🔍
build/styles/editor/style-rtl.css 18.8 kB +219 B (+1.18%)
build/styles/editor/style.css 18.8 kB +220 B (+1.18%)
ℹ️ View Unchanged
Filename Size
build/modules/a11y/index.min.js 355 B
build/modules/abilities/index.min.js 42.3 kB
build/modules/block-editor/utils/fit-text-frontend.min.js 549 B
build/modules/block-library/accordion/view.min.js 779 B
build/modules/block-library/file/view.min.js 346 B
build/modules/block-library/form/view.min.js 528 B
build/modules/block-library/image/view.min.js 1.95 kB
build/modules/block-library/navigation/view.min.js 1.03 kB
build/modules/block-library/query/view.min.js 518 B
build/modules/block-library/search/view.min.js 498 B
build/modules/block-library/tabs/view.min.js 859 B
build/modules/boot/index.min.js 104 kB
build/modules/core-abilities/index.min.js 890 B
build/modules/edit-site-init/index.min.js 2.14 kB
build/modules/interactivity-router/full-page.min.js 451 B
build/modules/interactivity-router/index.min.js 11.5 kB
build/modules/interactivity/index.min.js 14.9 kB
build/modules/latex-to-mathml/index.min.js 56.5 kB
build/modules/latex-to-mathml/loader.min.js 131 B
build/modules/lazy-editor/index.min.js 18.8 kB
build/modules/route/index.min.js 24.6 kB
build/modules/workflow/index.min.js 36.8 kB
build/scripts/a11y/index.min.js 1.06 kB
build/scripts/annotations/index.min.js 2.38 kB
build/scripts/api-fetch/index.min.js 2.83 kB
build/scripts/autop/index.min.js 2.18 kB
build/scripts/blob/index.min.js 631 B
build/scripts/block-directory/index.min.js 8.03 kB
build/scripts/block-editor/index.min.js 315 kB
build/scripts/block-serialization-default-parser/index.min.js 1.16 kB
build/scripts/block-serialization-spec-parser/index.min.js 3.08 kB
build/scripts/blocks/index.min.js 56.4 kB
build/scripts/commands/index.min.js 19.9 kB
build/scripts/components/index.min.js 273 kB
build/scripts/compose/index.min.js 13.9 kB
build/scripts/core-commands/index.min.js 4.13 kB
build/scripts/core-data/index.min.js 86.7 kB
build/scripts/customize-widgets/index.min.js 12.3 kB
build/scripts/data-controls/index.min.js 793 B
build/scripts/data/index.min.js 9.62 kB
build/scripts/date/index.min.js 23.6 kB
build/scripts/deprecated/index.min.js 752 B
build/scripts/dom-ready/index.min.js 476 B
build/scripts/dom/index.min.js 4.91 kB
build/scripts/edit-post/index.min.js 16.3 kB
build/scripts/edit-widgets/index.min.js 20 kB
build/scripts/element/index.min.js 5.19 kB
build/scripts/escape-html/index.min.js 586 B
build/scripts/format-library/index.min.js 10.8 kB
build/scripts/hooks/index.min.js 1.83 kB
build/scripts/html-entities/index.min.js 494 B
build/scripts/i18n/index.min.js 2.46 kB
build/scripts/is-shallow-equal/index.min.js 568 B
build/scripts/keyboard-shortcuts/index.min.js 1.57 kB
build/scripts/keycodes/index.min.js 1.53 kB
build/scripts/list-reusable-blocks/index.min.js 2.44 kB
build/scripts/media-utils/index.min.js 69.5 kB
build/scripts/notices/index.min.js 1.11 kB
build/scripts/nux/index.min.js 1.88 kB
build/scripts/patterns/index.min.js 7.87 kB
build/scripts/plugins/index.min.js 2.14 kB
build/scripts/preferences-persistence/index.min.js 2.15 kB
build/scripts/preferences/index.min.js 3.31 kB
build/scripts/primitives/index.min.js 1.01 kB
build/scripts/priority-queue/index.min.js 1.61 kB
build/scripts/private-apis/index.min.js 1.07 kB
build/scripts/react-i18n/index.min.js 832 B
build/scripts/react-refresh-entry/index.min.js 9.44 kB
build/scripts/react-refresh-runtime/index.min.js 3.59 kB
build/scripts/redux-routine/index.min.js 3.36 kB
build/scripts/reusable-blocks/index.min.js 2.93 kB
build/scripts/rich-text/index.min.js 12.9 kB
build/scripts/router/index.min.js 5.96 kB
build/scripts/server-side-render/index.min.js 1.91 kB
build/scripts/shortcode/index.min.js 1.58 kB
build/scripts/style-engine/index.min.js 2.33 kB
build/scripts/theme/index.min.js 20.8 kB
build/scripts/token-list/index.min.js 739 B
build/scripts/undo-manager/index.min.js 917 B
build/scripts/url/index.min.js 3.98 kB
build/scripts/vendors/react-dom.min.js 43 kB
build/scripts/vendors/react-jsx-runtime.min.js 691 B
build/scripts/vendors/react.min.js 4.27 kB
build/scripts/viewport/index.min.js 1.22 kB
build/scripts/warning/index.min.js 454 B
build/scripts/widgets/index.min.js 7.81 kB
build/scripts/wordcount/index.min.js 1.04 kB
build/styles/block-directory/style-rtl.css 1.05 kB
build/styles/block-directory/style.css 1.05 kB
build/styles/block-editor/content-rtl.css 4.8 kB
build/styles/block-editor/content.css 4.79 kB
build/styles/block-editor/default-editor-styles-rtl.css 224 B
build/styles/block-editor/default-editor-styles.css 224 B
build/styles/block-editor/style-rtl.css 16.4 kB
build/styles/block-editor/style.css 16.4 kB
build/styles/block-library/accordion-heading/style-rtl.css 325 B
build/styles/block-library/accordion-heading/style.css 325 B
build/styles/block-library/accordion-item/style-rtl.css 180 B
build/styles/block-library/accordion-item/style.css 180 B
build/styles/block-library/accordion-panel/style-rtl.css 99 B
build/styles/block-library/accordion-panel/style.css 99 B
build/styles/block-library/accordion/style-rtl.css 62 B
build/styles/block-library/accordion/style.css 62 B
build/styles/block-library/archives/editor-rtl.css 61 B
build/styles/block-library/archives/editor.css 61 B
build/styles/block-library/archives/style-rtl.css 90 B
build/styles/block-library/archives/style.css 90 B
build/styles/block-library/audio/editor-rtl.css 149 B
build/styles/block-library/audio/editor.css 151 B
build/styles/block-library/audio/style-rtl.css 132 B
build/styles/block-library/audio/style.css 132 B
build/styles/block-library/audio/theme-rtl.css 134 B
build/styles/block-library/audio/theme.css 134 B
build/styles/block-library/avatar/editor-rtl.css 115 B
build/styles/block-library/avatar/editor.css 115 B
build/styles/block-library/avatar/style-rtl.css 104 B
build/styles/block-library/avatar/style.css 104 B
build/styles/block-library/breadcrumbs/style-rtl.css 203 B
build/styles/block-library/breadcrumbs/style.css 203 B
build/styles/block-library/button/editor-rtl.css 265 B
build/styles/block-library/button/editor.css 265 B
build/styles/block-library/button/style-rtl.css 554 B
build/styles/block-library/button/style.css 554 B
build/styles/block-library/buttons/editor-rtl.css 291 B
build/styles/block-library/buttons/editor.css 291 B
build/styles/block-library/buttons/style-rtl.css 349 B
build/styles/block-library/buttons/style.css 349 B
build/styles/block-library/calendar/style-rtl.css 239 B
build/styles/block-library/calendar/style.css 239 B
build/styles/block-library/categories/editor-rtl.css 132 B
build/styles/block-library/categories/editor.css 131 B
build/styles/block-library/categories/style-rtl.css 152 B
build/styles/block-library/categories/style.css 152 B
build/styles/block-library/classic-rtl.css 321 B
build/styles/block-library/classic.css 321 B
build/styles/block-library/code/editor-rtl.css 53 B
build/styles/block-library/code/editor.css 53 B
build/styles/block-library/code/style-rtl.css 139 B
build/styles/block-library/code/style.css 139 B
build/styles/block-library/code/theme-rtl.css 122 B
build/styles/block-library/code/theme.css 122 B
build/styles/block-library/columns/editor-rtl.css 108 B
build/styles/block-library/columns/editor.css 108 B
build/styles/block-library/columns/style-rtl.css 421 B
build/styles/block-library/columns/style.css 421 B
build/styles/block-library/comment-author-avatar/editor-rtl.css 124 B
build/styles/block-library/comment-author-avatar/editor.css 124 B
build/styles/block-library/comment-author-name/style-rtl.css 72 B
build/styles/block-library/comment-author-name/style.css 72 B
build/styles/block-library/comment-content/style-rtl.css 120 B
build/styles/block-library/comment-content/style.css 120 B
build/styles/block-library/comment-date/style-rtl.css 65 B
build/styles/block-library/comment-date/style.css 65 B
build/styles/block-library/comment-edit-link/style-rtl.css 70 B
build/styles/block-library/comment-edit-link/style.css 70 B
build/styles/block-library/comment-reply-link/style-rtl.css 71 B
build/styles/block-library/comment-reply-link/style.css 71 B
build/styles/block-library/comment-template/style-rtl.css 191 B
build/styles/block-library/comment-template/style.css 191 B
build/styles/block-library/comments-pagination-numbers/editor-rtl.css 122 B
build/styles/block-library/comments-pagination-numbers/editor.css 121 B
build/styles/block-library/comments-pagination/editor-rtl.css 168 B
build/styles/block-library/comments-pagination/editor.css 168 B
build/styles/block-library/comments-pagination/style-rtl.css 201 B
build/styles/block-library/comments-pagination/style.css 201 B
build/styles/block-library/comments-title/editor-rtl.css 75 B
build/styles/block-library/comments-title/editor.css 75 B
build/styles/block-library/comments/editor-rtl.css 842 B
build/styles/block-library/comments/editor.css 842 B
build/styles/block-library/comments/style-rtl.css 637 B
build/styles/block-library/comments/style.css 637 B
build/styles/block-library/common-rtl.css 1.11 kB
build/styles/block-library/common.css 1.11 kB
build/styles/block-library/cover/editor-rtl.css 631 B
build/styles/block-library/cover/editor.css 631 B
build/styles/block-library/cover/style-rtl.css 1.82 kB
build/styles/block-library/cover/style.css 1.81 kB
build/styles/block-library/details/editor-rtl.css 65 B
build/styles/block-library/details/editor.css 65 B
build/styles/block-library/details/style-rtl.css 86 B
build/styles/block-library/details/style.css 86 B
build/styles/block-library/editor-elements-rtl.css 75 B
build/styles/block-library/editor-elements.css 75 B
build/styles/block-library/editor-rtl.css 11.8 kB
build/styles/block-library/editor.css 11.8 kB
build/styles/block-library/elements-rtl.css 54 B
build/styles/block-library/elements.css 54 B
build/styles/block-library/embed/editor-rtl.css 331 B
build/styles/block-library/embed/editor.css 331 B
build/styles/block-library/embed/style-rtl.css 448 B
build/styles/block-library/embed/style.css 448 B
build/styles/block-library/embed/theme-rtl.css 133 B
build/styles/block-library/embed/theme.css 133 B
build/styles/block-library/file/editor-rtl.css 324 B
build/styles/block-library/file/editor.css 324 B
build/styles/block-library/file/style-rtl.css 278 B
build/styles/block-library/file/style.css 278 B
build/styles/block-library/footnotes/style-rtl.css 198 B
build/styles/block-library/footnotes/style.css 197 B
build/styles/block-library/form-input/editor-rtl.css 229 B
build/styles/block-library/form-input/editor.css 229 B
build/styles/block-library/form-input/style-rtl.css 366 B
build/styles/block-library/form-input/style.css 366 B
build/styles/block-library/form-submission-notification/editor-rtl.css 344 B
build/styles/block-library/form-submission-notification/editor.css 341 B
build/styles/block-library/form-submit-button/style-rtl.css 69 B
build/styles/block-library/form-submit-button/style.css 69 B
build/styles/block-library/freeform/editor-rtl.css 2.59 kB
build/styles/block-library/freeform/editor.css 2.59 kB
build/styles/block-library/gallery/editor-rtl.css 615 B
build/styles/block-library/gallery/editor.css 616 B
build/styles/block-library/gallery/style-rtl.css 1.84 kB
build/styles/block-library/gallery/style.css 1.84 kB
build/styles/block-library/gallery/theme-rtl.css 108 B
build/styles/block-library/gallery/theme.css 108 B
build/styles/block-library/group/editor-rtl.css 335 B
build/styles/block-library/group/editor.css 335 B
build/styles/block-library/group/style-rtl.css 103 B
build/styles/block-library/group/style.css 103 B
build/styles/block-library/group/theme-rtl.css 79 B
build/styles/block-library/group/theme.css 79 B
build/styles/block-library/heading/style-rtl.css 205 B
build/styles/block-library/heading/style.css 205 B
build/styles/block-library/html/editor-rtl.css 419 B
build/styles/block-library/html/editor.css 419 B
build/styles/block-library/image/editor-rtl.css 763 B
build/styles/block-library/image/editor.css 763 B
build/styles/block-library/image/style-rtl.css 1.6 kB
build/styles/block-library/image/style.css 1.59 kB
build/styles/block-library/image/theme-rtl.css 137 B
build/styles/block-library/image/theme.css 137 B
build/styles/block-library/latest-comments/style-rtl.css 355 B
build/styles/block-library/latest-comments/style.css 354 B
build/styles/block-library/latest-posts/editor-rtl.css 139 B
build/styles/block-library/latest-posts/editor.css 138 B
build/styles/block-library/latest-posts/style-rtl.css 520 B
build/styles/block-library/latest-posts/style.css 520 B
build/styles/block-library/list/style-rtl.css 107 B
build/styles/block-library/list/style.css 107 B
build/styles/block-library/loginout/style-rtl.css 61 B
build/styles/block-library/loginout/style.css 61 B
build/styles/block-library/math/editor-rtl.css 105 B
build/styles/block-library/math/editor.css 105 B
build/styles/block-library/math/style-rtl.css 61 B
build/styles/block-library/math/style.css 61 B
build/styles/block-library/media-text/editor-rtl.css 321 B
build/styles/block-library/media-text/editor.css 320 B
build/styles/block-library/media-text/style-rtl.css 543 B
build/styles/block-library/media-text/style.css 542 B
build/styles/block-library/more/editor-rtl.css 393 B
build/styles/block-library/more/editor.css 393 B
build/styles/block-library/navigation-link/editor-rtl.css 645 B
build/styles/block-library/navigation-link/editor.css 647 B
build/styles/block-library/navigation-link/style-rtl.css 190 B
build/styles/block-library/navigation-link/style.css 188 B
build/styles/block-library/navigation-submenu/editor-rtl.css 295 B
build/styles/block-library/navigation-submenu/editor.css 294 B
build/styles/block-library/navigation/editor-rtl.css 2.25 kB
build/styles/block-library/navigation/editor.css 2.26 kB
build/styles/block-library/navigation/style-rtl.css 2.27 kB
build/styles/block-library/navigation/style.css 2.25 kB
build/styles/block-library/nextpage/editor-rtl.css 392 B
build/styles/block-library/nextpage/editor.css 392 B
build/styles/block-library/page-list/editor-rtl.css 356 B
build/styles/block-library/page-list/editor.css 356 B
build/styles/block-library/page-list/style-rtl.css 192 B
build/styles/block-library/page-list/style.css 192 B
build/styles/block-library/paragraph/editor-rtl.css 251 B
build/styles/block-library/paragraph/editor.css 251 B
build/styles/block-library/paragraph/style-rtl.css 341 B
build/styles/block-library/paragraph/style.css 340 B
build/styles/block-library/post-author-biography/style-rtl.css 74 B
build/styles/block-library/post-author-biography/style.css 74 B
build/styles/block-library/post-author-name/style-rtl.css 69 B
build/styles/block-library/post-author-name/style.css 69 B
build/styles/block-library/post-author/style-rtl.css 188 B
build/styles/block-library/post-author/style.css 189 B
build/styles/block-library/post-comments-count/style-rtl.css 72 B
build/styles/block-library/post-comments-count/style.css 72 B
build/styles/block-library/post-comments-form/editor-rtl.css 96 B
build/styles/block-library/post-comments-form/editor.css 96 B
build/styles/block-library/post-comments-form/style-rtl.css 525 B
build/styles/block-library/post-comments-form/style.css 525 B
build/styles/block-library/post-comments-link/style-rtl.css 71 B
build/styles/block-library/post-comments-link/style.css 71 B
build/styles/block-library/post-content/style-rtl.css 61 B
build/styles/block-library/post-content/style.css 61 B
build/styles/block-library/post-date/style-rtl.css 62 B
build/styles/block-library/post-date/style.css 62 B
build/styles/block-library/post-excerpt/editor-rtl.css 71 B
build/styles/block-library/post-excerpt/editor.css 71 B
build/styles/block-library/post-excerpt/style-rtl.css 155 B
build/styles/block-library/post-excerpt/style.css 155 B
build/styles/block-library/post-featured-image/editor-rtl.css 719 B
build/styles/block-library/post-featured-image/editor.css 717 B
build/styles/block-library/post-featured-image/style-rtl.css 347 B
build/styles/block-library/post-featured-image/style.css 347 B
build/styles/block-library/post-navigation-link/style-rtl.css 215 B
build/styles/block-library/post-navigation-link/style.css 214 B
build/styles/block-library/post-template/style-rtl.css 414 B
build/styles/block-library/post-template/style.css 414 B
build/styles/block-library/post-terms/style-rtl.css 96 B
build/styles/block-library/post-terms/style.css 96 B
build/styles/block-library/post-time-to-read/style-rtl.css 70 B
build/styles/block-library/post-time-to-read/style.css 70 B
build/styles/block-library/post-title/style-rtl.css 162 B
build/styles/block-library/post-title/style.css 162 B
build/styles/block-library/preformatted/style-rtl.css 125 B
build/styles/block-library/preformatted/style.css 125 B
build/styles/block-library/pullquote/editor-rtl.css 133 B
build/styles/block-library/pullquote/editor.css 133 B
build/styles/block-library/pullquote/style-rtl.css 365 B
build/styles/block-library/pullquote/style.css 365 B
build/styles/block-library/pullquote/theme-rtl.css 176 B
build/styles/block-library/pullquote/theme.css 176 B
build/styles/block-library/query-pagination-numbers/editor-rtl.css 121 B
build/styles/block-library/query-pagination-numbers/editor.css 118 B
build/styles/block-library/query-pagination/editor-rtl.css 154 B
build/styles/block-library/query-pagination/editor.css 154 B
build/styles/block-library/query-pagination/style-rtl.css 237 B
build/styles/block-library/query-pagination/style.css 237 B
build/styles/block-library/query-title/style-rtl.css 64 B
build/styles/block-library/query-title/style.css 64 B
build/styles/block-library/query-total/style-rtl.css 64 B
build/styles/block-library/query-total/style.css 64 B
build/styles/block-library/query/editor-rtl.css 438 B
build/styles/block-library/query/editor.css 438 B
build/styles/block-library/quote/style-rtl.css 238 B
build/styles/block-library/quote/style.css 238 B
build/styles/block-library/quote/theme-rtl.css 233 B
build/styles/block-library/quote/theme.css 236 B
build/styles/block-library/read-more/style-rtl.css 131 B
build/styles/block-library/read-more/style.css 131 B
build/styles/block-library/reset-rtl.css 472 B
build/styles/block-library/reset.css 472 B
build/styles/block-library/rss/editor-rtl.css 126 B
build/styles/block-library/rss/editor.css 126 B
build/styles/block-library/rss/style-rtl.css 284 B
build/styles/block-library/rss/style.css 283 B
build/styles/block-library/search/editor-rtl.css 199 B
build/styles/block-library/search/editor.css 199 B
build/styles/block-library/search/style-rtl.css 665 B
build/styles/block-library/search/style.css 666 B
build/styles/block-library/search/theme-rtl.css 113 B
build/styles/block-library/search/theme.css 113 B
build/styles/block-library/separator/editor-rtl.css 100 B
build/styles/block-library/separator/editor.css 100 B
build/styles/block-library/separator/style-rtl.css 248 B
build/styles/block-library/separator/style.css 248 B
build/styles/block-library/separator/theme-rtl.css 195 B
build/styles/block-library/separator/theme.css 195 B
build/styles/block-library/shortcode/editor-rtl.css 286 B
build/styles/block-library/shortcode/editor.css 286 B
build/styles/block-library/site-logo/editor-rtl.css 773 B
build/styles/block-library/site-logo/editor.css 770 B
build/styles/block-library/site-logo/style-rtl.css 218 B
build/styles/block-library/site-logo/style.css 218 B
build/styles/block-library/site-tagline/editor-rtl.css 87 B
build/styles/block-library/site-tagline/editor.css 87 B
build/styles/block-library/site-tagline/style-rtl.css 65 B
build/styles/block-library/site-tagline/style.css 65 B
build/styles/block-library/site-title/editor-rtl.css 85 B
build/styles/block-library/site-title/editor.css 85 B
build/styles/block-library/site-title/style-rtl.css 143 B
build/styles/block-library/site-title/style.css 143 B
build/styles/block-library/social-link/editor-rtl.css 314 B
build/styles/block-library/social-link/editor.css 314 B
build/styles/block-library/social-links/editor-rtl.css 339 B
build/styles/block-library/social-links/editor.css 338 B
build/styles/block-library/social-links/style-rtl.css 1.51 kB
build/styles/block-library/social-links/style.css 1.51 kB
build/styles/block-library/spacer/editor-rtl.css 346 B
build/styles/block-library/spacer/editor.css 346 B
build/styles/block-library/spacer/style-rtl.css 48 B
build/styles/block-library/spacer/style.css 48 B
build/styles/block-library/style-rtl.css 16.5 kB
build/styles/block-library/style.css 16.5 kB
build/styles/block-library/tab/style-rtl.css 202 B
build/styles/block-library/tab/style.css 202 B
build/styles/block-library/table-of-contents/style-rtl.css 83 B
build/styles/block-library/table-of-contents/style.css 83 B
build/styles/block-library/table/editor-rtl.css 394 B
build/styles/block-library/table/editor.css 394 B
build/styles/block-library/table/style-rtl.css 641 B
build/styles/block-library/table/style.css 640 B
build/styles/block-library/table/theme-rtl.css 152 B
build/styles/block-library/table/theme.css 152 B
build/styles/block-library/tabs/editor-rtl.css 236 B
build/styles/block-library/tabs/editor.css 236 B
build/styles/block-library/tabs/style-rtl.css 983 B
build/styles/block-library/tabs/style.css 983 B
build/styles/block-library/tag-cloud/editor-rtl.css 92 B
build/styles/block-library/tag-cloud/editor.css 92 B
build/styles/block-library/tag-cloud/style-rtl.css 248 B
build/styles/block-library/tag-cloud/style.css 248 B
build/styles/block-library/template-part/editor-rtl.css 368 B
build/styles/block-library/template-part/editor.css 368 B
build/styles/block-library/template-part/theme-rtl.css 113 B
build/styles/block-library/template-part/theme.css 113 B
build/styles/block-library/term-count/style-rtl.css 63 B
build/styles/block-library/term-count/style.css 63 B
build/styles/block-library/term-description/style-rtl.css 126 B
build/styles/block-library/term-description/style.css 126 B
build/styles/block-library/term-name/style-rtl.css 62 B
build/styles/block-library/term-name/style.css 62 B
build/styles/block-library/term-template/editor-rtl.css 225 B
build/styles/block-library/term-template/editor.css 225 B
build/styles/block-library/term-template/style-rtl.css 114 B
build/styles/block-library/term-template/style.css 114 B
build/styles/block-library/text-columns/editor-rtl.css 95 B
build/styles/block-library/text-columns/editor.css 95 B
build/styles/block-library/text-columns/style-rtl.css 165 B
build/styles/block-library/text-columns/style.css 165 B
build/styles/block-library/theme-rtl.css 715 B
build/styles/block-library/theme.css 719 B
build/styles/block-library/verse/style-rtl.css 123 B
build/styles/block-library/verse/style.css 123 B
build/styles/block-library/video/editor-rtl.css 415 B
build/styles/block-library/video/editor.css 416 B
build/styles/block-library/video/style-rtl.css 202 B
build/styles/block-library/video/style.css 202 B
build/styles/block-library/video/theme-rtl.css 134 B
build/styles/block-library/video/theme.css 134 B
build/styles/commands/style-rtl.css 1.72 kB
build/styles/commands/style.css 1.72 kB
build/styles/components/style-rtl.css 14 kB
build/styles/components/style.css 14 kB
build/styles/customize-widgets/style-rtl.css 1.44 kB
build/styles/customize-widgets/style.css 1.44 kB
build/styles/edit-post/classic-rtl.css 426 B
build/styles/edit-post/classic.css 427 B
build/styles/edit-post/style-rtl.css 3.38 kB
build/styles/edit-post/style.css 3.38 kB
build/styles/edit-site/style-rtl.css 15.9 kB
build/styles/edit-site/style.css 15.9 kB
build/styles/edit-widgets/style-rtl.css 4.62 kB
build/styles/edit-widgets/style.css 4.62 kB
build/styles/format-library/style-rtl.css 326 B
build/styles/format-library/style.css 326 B
build/styles/list-reusable-blocks/style-rtl.css 1.02 kB
build/styles/list-reusable-blocks/style.css 1.02 kB
build/styles/media-utils/style-rtl.css 400 B
build/styles/media-utils/style.css 400 B
build/styles/nux/style-rtl.css 622 B
build/styles/nux/style.css 618 B
build/styles/patterns/style-rtl.css 611 B
build/styles/patterns/style.css 611 B
build/styles/preferences/style-rtl.css 415 B
build/styles/preferences/style.css 415 B
build/styles/reusable-blocks/style-rtl.css 275 B
build/styles/reusable-blocks/style.css 275 B
build/styles/widgets/style-rtl.css 1.17 kB
build/styles/widgets/style.css 1.18 kB

compressed-size-action

@github-actions
Copy link

github-actions bot commented Dec 8, 2025

Flaky tests detected in a4c5e69.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/20088225567
📝 Reported issues:

@andrewserong andrewserong force-pushed the try/media-editor-state-within-the-editor branch from 8405da3 to 6878c4c Compare December 10, 2025 04:45
@andrewserong
Copy link
Contributor Author

Just pinging a few folks I've been chatting with about the idea of introducing a media editor. This PR isn't ready for a proper review, but I wanted to gauge a general sense of whether injecting this into the editor package is the right path. It's feeling pretty good to me, but before I polish this, I wanted to double-check it seems okay. There's lots of conditions added to make it work, which is potentially a con, however the pro is that a lot of stuff "just works" and it's nice that the publish flows, updating titles, the document bar, etc, all seem to work naturally with attachments.

FYI: @youknowriad @tellthemachines @ramonjd @talldan @aaronrobertshaw

I'll continue chipping away at this, but happy for any early feedback.

Copy link
Contributor

@youknowriad youknowriad left a comment

Choose a reason for hiding this comment

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

The main downside of this PR is that you'll be forced to load all the blocks and dependencies (which potentially is a lot of MBs) when you want to load the media editor. I agree there's something nice with having the same API as the regular Editor component though but I'm very hesitant of this approach.

@ramonjd
Copy link
Member

ramonjd commented Dec 10, 2025

Thanks for getting this started @andrewserong

The main downside of this PR is that you'll be forced to load all the blocks and dependencies (which potentially is a lot of MBs) when you want to load the media editor.

I understood from the PR description that it demonstrates the workflow, but the eventual objective was some kind of @wordpress/media-editor|library package with a suite of media editing components that would be consumable by the editor rather than embedded within it.

Could a lazy import then help in that case?

The caveat to all this is that we don't have much of an idea how a media (and media metatdata) editor fits into the UX of the editor yet. I think it needs some design.

Also, I'm not sure about loading blocks? Does the media editor care about blocks?

@andrewserong
Copy link
Contributor Author

I understood from the PR description that it demonstrates the workflow, but the eventual objective was some kind of @wordpress/media-editor|library package with a suite of media editing components that would be consumable by the editor rather than embedded within it.

Yes, the idea in this PR was to first introduce these things as part of editor, but that it could eventually be split out. An alternative, of course, would be to build a separate thing that looks like the editor but exists in parallel. I suppose a bit like how we have the edit-site package, but instead it'd be media-editor or something of the sort.

The caveat to all this is that we don't have much of an idea how a media (and media metatdata) editor fits into the UX of the editor yet. I think it needs some design.

Totally. The entrypoint I went with for this PR was simply to add an "Edit media" button to the block toolbar, but I'm sure there's lots of other ways we could do it. For now, the idea I had in mind was to try to make things feel fluid from the perspective of "I'm in the editor and would like to edit this photo" rather than beginning from wp-admin. But there'll be lots of stuff to explore!

I agree there's something nice with having the same API as the regular Editor component though but I'm very hesitant of this approach.

Thanks for the feedback! Did you have any other approaches in mind for how it might ideally work? No worries if not of course, but I always like hearing your thoughts on these matters 🙂

I think an alternative PR to try to this one, to see how it'd all feel, would be to create a separate package and load up the media editor in a similar(ish) way to how we have the site editor separate from the post editor. It'll create a cleaner separation of concerns, but potentially a little more duplication. That said, this PR has heaps of conditions that aren't easy to reason about, so it really might be a better thing all around to make it a bit more separate.

I'll be AFK for five days or so after today, so I won't get back to any feedback immediately, but I'll happily either try out more ideas in this PR, or start an alternative PR to try out a separate media-editor package and route, once I return.

Thanks everyone!

@youknowriad
Copy link
Contributor

To be really clear I really like the back and forth between "media" and other editable elements that the current PR offers (onNavigateToEntity...). And this would be harder to achieve with a separate package / editor (not impossible).

The main downside though remains the same, if you want to just open the "media editor" kind of in isolation, you may be forced to load the blocks and such. I'm not sure I measure how much of this is a trouble or not. Also, could be a non issue if the "attachment" editors needs blocks in any way.

The potential alternative would potentially be an "Editor" package that acts as a "router" kind of per post type and only loads the blocks... if needed (sounds great on paper, but probably not a small project :P)

@andrewserong
Copy link
Contributor Author

To be really clear I really like the back and forth between "media" and other editable elements that the current PR offers

That's my favourite part, too, that it can actually feel quite slick if we get it working right.

The main downside though remains the same, if you want to just open the "media editor" kind of in isolation, you may be forced to load the blocks and such. I'm not sure I measure how much of this is a trouble or not. Also, could be a non issue if the "attachment" editors needs blocks in any way.

This is an interesting one. Off the top of my head I have a couple of ideas:

  • It may be possible to try to build much of this using as many reusable components as possible so that we actually have two versions of the media editor — one that's part of editor and easy to get to, and another that's lighter weight and that can be loaded directly without all the block stuff. But also:
  • We might conceivably want to use blocks stuff in the future if we consider ways of previewing media within the context of blocks and/or theme.json settings and styles. This isn't MVP territory, but for example, previewing the media when it has aspect ratios or Duotone applied — but as a preview of how it'll work in a block, rather than a destructive edit.

In any case, all just ideas for now! If / when we settle on a path forward that we like, we can always try landing things behind an experiment.

In the shorter-term, I'll give a bit more thought to how we can build things in a reusable way.

@ramonjd
Copy link
Member

ramonjd commented Dec 10, 2025

It may be possible to try to build much of this using as many reusable components as possible so that we actually have two versions of the media editor

Thanks, folks. That's where my brain was going. Like a package that exports all this stuff, ready to be consumed by any editor or other package.

@andrewserong
Copy link
Contributor Author

Alrighty, I've pushed a change in d5704a1 that inches toward this idea by moving the media-specific bits that we can into a media-editor package. Everything else is still "part" of the the editor for now in this PR.

I think the next thing for me to try, keeping in the spirit of this being a proof of concept, will be to try out adding a completely separate route (perhaps using the dedicated font library as inspiration: #73630).

I'll continue hacking on this idea, but something that I really liked about #73630 as a point of inspiration, is that the font library itself lives in global-styles-ui and there is a separate routes/font-list for the dedicated page. I.e. the next thing I think for me to try would be something like a routes/media-editor that sets things up and (hopefully) re-uses some of these components from packages/media-editor.

My plan will be to continue on with this being the "kitchen sink" PR for these ideas, as it's helpful to try it all out in one place. If / when we land in a good place with it, we can split it out into separate, more polished PRs if it looks too unwieldy.


Also, while I'm hacking on this with Claude, things will likely look a little messy / strange as I'm not looking at the code in too much detail just yet. That said, do feel free to continue to drop any ideas anyone thinks worth pursuing here, and I'll take a look.

For now, I'll keep hacking on the ideas here and see how it all might look.

@youknowriad
Copy link
Contributor

Alrighty, I've pushed a change in d5704a1 that inches toward this idea by moving the media-specific bits that we can into a media-editor package. Everything else is still "part" of the the editor for now in this PR.

I think this is a good direction indeed. What's the API for that package though? I'd love for this package to be considered as the same level of abstraction compared to what "block-editor" is for blocks. In other words something like:

<MediaEditorProvider value={media} onChange={updateMedia} settings={settings}>
    <MediaPreview />
    <MediaControls />
</MediaEditorProvider>

Would something like this make sense? (A WordPress agnostic media editor package).

I do think we need to think this properly before committing too much though.

@ramonjd
Copy link
Member

ramonjd commented Dec 11, 2025

Would something like this make sense? (A WordPress agnostic media editor package).

I like that idea. We need to handle attachment post types as well to deal with the metadata, so would it make sense to wrap it in <EntityProvider kind="postType" type="attachment" id={ post.id } />.

Or maybe the dataview attachment item modal could work here, passed down via context 🤔

@youknowriad
Copy link
Contributor

I like that idea. We need to handle attachment post types as well to deal with the metadata, so would it make sense to wrap it in <EntityProvider kind="postType" type="attachment" id={ post.id } />.

If it's a WP agnostic package we can't use entity provider, but the "value" prop and "onChange" should be enough to be able to read/edit the object

@andrewserong
Copy link
Contributor Author

Would something like this make sense? (A WordPress agnostic media editor package).

I like this idea. If we manage to do it right, I'd love it if we could create a media-editor package that someone could one day use to build an Electron app for a dedicated (yet simple) image / media editor, a bit like how Block Notes is built using capacitor on top of the block-editor package.

I wouldn't consider it the first goal of this work per se, as the WordPress / Gutenberg use case is the primary one, but I really like the idea of it being fairly general purpose.

I'm imagining it would then be up to the route and editor packages to handle the WP-specific bits...

I do think we need to think this properly before committing too much though.

Indeed. My intention is to continue hacking on the ideas here, and to try things out to see how they feel before attempting to land an approach. I think hooking up a route will help tease apart some of the questions, as that'll give us the two entry points to the media editor and hopefully make it clearer what the shape of the API will need to be.

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

Labels

[Feature] Media Anything that impacts the experience of managing media [Type] Experimental Experimental feature or API.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants