Index: wp-admin/includes/media.php =================================================================== --- wp-admin/includes/media.php (revision 58923) +++ wp-admin/includes/media.php (working copy) @@ -456,6 +456,13 @@ function wp_media_attach_alt_text( $form_fields, $post ) { if ( 'image' === substr( $post->post_mime_type, 0, 5 ) ) { $form_fields['post_excerpt']['label'] = __( 'Alternative Text' ); + // Add a placeholder to clarify that alt text is context-dependent. + $form_fields['post_excerpt']['placeholder'] = __( 'Describe the purpose of this image in this specific context.' ); + // Add help text with a link to the W3C Alt Text Decision Tree. + $form_fields['post_excerpt']['help'] = sprintf( + __( 'Alt text describes the image\'s purpose, not just its appearance. Learn more about writing good alt text. Leave empty if decorative.' ), + 'https://www.w3.org/WAI/tutorials/images/decision-tree/' + ); } return $form_fields; }