Problem/Motivation
While discussing #3370326: Refine field descriptions at #3498619: Drupal Usability Meeting 2025-01-17, we agreed that the Media option should be part of the same group as File and Image uploads. Although these options are very different in terms of implementation, they are similar in how they are used.
For a long time, we have had the description text,
Use Media reference fields for most files, images, audio, videos, and remote media. Use File or Image reference fields when creating your own media types, or for legacy files and images created before installing the Media module. For more information, see the Media help page.
A more effective way to make this distinction would be to have all three options on the same screen.
Proposed resolution
Instead of showing Media as a separate option on admin/structure/types/manage/page/fields/add-field (Add field: Choose a type of field), add it to the next step of the form, after selecting "File upload".
Revise the text for that field group (currently "File upload").
Remaining tasks
User interface changes
Before
Choose a type of field:
After selecting Media:
After selecting File upload:
Introduced terminology
None
API changes
None
Data model changes
None
Release notes snippet
N/A