diff --git a/README.md b/README.md
index 4b45e58e741a4aaf58ba62d0aa3d02c78f3834fb..66476877e8ea71ac16a5807944213493906377d7 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,19 @@ dependency since Drupal 9.4 and a requirement for Drupal 10).
 At the moment this branch still have incompatibilities with packages locked to
 php-http/guzzle6-adapter dependency (see issue #3283651).
 
+### How to seamlessly upgrade to Drupal 10 & Geocoder 4.x ... ###
+
+When preparing for an upgrade to Drupal 10 we recommend that you widen your composer version constraints to allow either 3.x or 4.x.
+Edit composer.json the following way:
+
+```
+"require": {
+...
+"drupal/geocoder": "^3.20 || ^4.0",
+...
+}
+```
+
 # Features
 * Solid API based on [Geocoder PHP library](http://geocoder-php.org);
 * Geocode and Reverse Geocode using one or multiple Geocoder providers