diff --git a/docs/changelog.rst b/docs/changelog.rst
index 21b0ae0bc..6f0c2e835 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -23,6 +23,22 @@ New features:
 
 .. _NO_COLOR: https://no-color.org
 
+For plugin developers:
+
+* `MediaFile`_ has been split into a standalone project. Where you used to do
+  ``from beets import mediafile``, now just do ``import mediafile``. Beets
+  re-exports MediaFile at the old location for backwards-compatibility, but a
+  deprecation warning is raised if you do this since we might drop this wrapper
+  in a future release.
+
+For packagers:
+
+* Beets' library for manipulating media file metadata has now been split to a
+  standalone project called `MediaFile`_, released as :pypi:`mediafile`. Beets
+  now depends on this new package.
+
+.. _MediaFile: https://github.com/beetbox/mediafile
+
 
 1.4.8 (May 16, 2019)
 --------------------