diff --git a/packages/editor/src/components/block-drop-zone/README.md b/packages/editor/src/components/block-drop-zone/README.md
new file mode 100644
index 00000000000000..ed979c19c184a7
--- /dev/null
+++ b/packages/editor/src/components/block-drop-zone/README.md
@@ -0,0 +1,30 @@
+BlockDropZone
+===========
+
+`BlockDropZone` is a React component that renders a container which allows a user to drag media into the editor and immediately place it.
+
+## Setup
+
+It includes a `wp.hooks` filter `editor.BlockDropZone` that enables developers to replace or extend it.
+
+_Example:_
+
+Replace implementation of the drop zone:
+
+```js
+function replaceBlockDropZone() {
+ return function() {
+ return wp.element.createElement(
+ 'div',
+ {},
+ 'The replacement contents or components.'
+ );
+ }
+}
+
+wp.hooks.addFilter(
+ 'editor.BlockDropZone',
+ 'my-plugin/replace-block-drop-zone',
+ replaceBlockDropZone
+);
+```
diff --git a/packages/editor/src/components/block-drop-zone/index.js b/packages/editor/src/components/block-drop-zone/index.js
index 5c4df43bb4ad51..885a54fe5a4d73 100644
--- a/packages/editor/src/components/block-drop-zone/index.js
+++ b/packages/editor/src/components/block-drop-zone/index.js
@@ -6,7 +6,10 @@ import classnames from 'classnames';
/**
* WordPress dependencies
*/
-import { DropZone } from '@wordpress/components';
+import {
+ DropZone,
+ withFilters,
+} from '@wordpress/components';
import {
rawHandler,
getBlockTransforms,
@@ -149,5 +152,6 @@ export default compose(
isLocked: !! getTemplateLock( rootClientId ),
getClientIdsOfDescendants,
};
- } )
+ } ),
+ withFilters( 'editor.BlockDropZone' )
)( BlockDropZone );
diff --git a/packages/editor/src/components/default-block-appender/test/__snapshots__/index.js.snap b/packages/editor/src/components/default-block-appender/test/__snapshots__/index.js.snap
index a3b6b410ce3eef..46c017374b5149 100644
--- a/packages/editor/src/components/default-block-appender/test/__snapshots__/index.js.snap
+++ b/packages/editor/src/components/default-block-appender/test/__snapshots__/index.js.snap
@@ -5,7 +5,7 @@ exports[`DefaultBlockAppender should append a default block when input focused 1
className="wp-block editor-default-block-appender"
data-root-client-id=""
>
-
+
-
+
-
+