diff --git a/packages/block-editor/src/components/media-placeholder/README.md b/packages/block-editor/src/components/media-placeholder/README.md
index b730b9af5cbc9..58140cf99e721 100644
--- a/packages/block-editor/src/components/media-placeholder/README.md
+++ b/packages/block-editor/src/components/media-placeholder/README.md
@@ -155,9 +155,9 @@ The argument of the callback is an object containing the following properties:
 
 ### value
 
-Media ID (or media IDs if multiple is true) to be selected by default when opening the media library.
+An object or an array of objects that contain media ID (`id` property) to be selected by default when opening the media library.
 
-- Type: `Number|Array`
+- Type: `Object|Array`
 - Required: No
 - Platform: Web
 
diff --git a/packages/block-editor/src/components/media-upload/README.md b/packages/block-editor/src/components/media-upload/README.md
index d445348fa0b15..ea09687102ec0 100644
--- a/packages/block-editor/src/components/media-upload/README.md
+++ b/packages/block-editor/src/components/media-upload/README.md
@@ -38,7 +38,7 @@ function MyMediaUploader() {
 			<MediaUpload
 				onSelect={ ( media ) => console.log( 'selected ' + media.length ) }
 				allowedTypes={ ALLOWED_MEDIA_TYPES }
-				value={ mediaId }
+				value={ media }
 				render={ ( { open } ) => (
 					<Button onClick={ open }>
 						Open Media Library
@@ -76,9 +76,9 @@ Whether to allow multiple selections or not.
 
 ### value
 
-Media ID (or media IDs if multiple is true) to be selected by default when opening the media library.
+An object or an array of objects that contain media ID (`id` property) to be selected by default when opening the media library.
 
-- Type: `Number|Array`
+- Type: `Object|Array`
 - Required: No
 - Platform: Web