diff --git a/docs/converting-images/defining-conversions.md b/docs/converting-images/defining-conversions.md
index a19ca0c54..563320647 100644
--- a/docs/converting-images/defining-conversions.md
+++ b/docs/converting-images/defining-conversions.md
@@ -7,7 +7,7 @@ When adding files to the media library it can automatically create derived versi
 
 Media conversions will be executed whenever  a `jpg`, `png`, `svg`, `webp`, `avif`, `pdf`, `mp4 `, `mov` or `webm` file is added to the media library. By default, the conversions will be saved as a `jpg` files. This can be overwritten using the `format()` or `keepOriginalImageFormat()` methods.
 
-Internally, [spatie/image](https://spatie.be/docs/image/v1) is used to manipulate the images. You can use [any manipulation function](https://spatie.be/docs/image) from that package.
+Internally, [spatie/image](https://spatie.be/docs/image/v3) is used to manipulate the images. You can use [any manipulation function](https://spatie.be/docs/image) from that package.
 
 Please check [the image generator docs](/docs/laravel-medialibrary/v11/converting-other-file-types/using-image-generators) for additional installation requirements when working with PDF, SVG or video formats.
 
diff --git a/docs/handling-uploads-with-media-library-pro/upgrading.md b/docs/handling-uploads-with-media-library-pro/upgrading.md
index fb30f5b5d..68a50ebad 100644
--- a/docs/handling-uploads-with-media-library-pro/upgrading.md
+++ b/docs/handling-uploads-with-media-library-pro/upgrading.md
@@ -7,6 +7,12 @@ weight: 10
 
 This file contains instructions on how to upgrade to another major version of the package.
 
+## From v3 to v4
+
+The main change in v4 is that we upgraded the required version of Media Library from v10 to v11. Under the hood spatie/image v3 is used instead of v2. 
+
+In the latest version of spatie/image some of the manipulations methods have been renamed. If you're using any of these methods in your code, you'll need to update them. Take a look at the [defining conversions page](/docs/laravel-medialibrary/v11/converting-images/defining-conversions) to learn more.
+
 ## From v2 to v3
 
 The main change in v3 is that we now use Livewire 3.0 instead of Livewire 2.0. If you're using the JavaScript component, then there are no breaking changes.