diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7eb2fa25..8cb4d5e9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -42,6 +42,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com), and this
 
   See [UPGRADE](UPGRADE.md#from-v2x-to-v3x) doc in order to get details on how to migrate to this version.
 
+* [#1347](https://github.com/shlinkio/shlink/issues/1347) Dropped support for regular swoole in favor of openswoole.
+
+  Since openswoole support was introduced in the previous release version, Shlink will still consider the swoole extension as openswoole, as at the moment functionality hasn't deviated too much, and will simplify migrating to Shlink 3.0.0
+
+  However, there's no longer active testing with regular swoole, and it is considered no longer supported. If some incompatibility arises, the only supported solution will be to migrate to openswoole.
+
 ### Fixed
 * *Nothing*
 
diff --git a/UPGRADE.md b/UPGRADE.md
index 7988276d..0d79cff1 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -46,6 +46,7 @@
 * The docker image no longer accepts providing configuration via json files mounted in the `config/params` folder. Only env vars are supported now.
 * If you were manually serving Shlink with swoole, the entry script has to be changed from `/path/to/shlink/vendor/bin/mezzio-swoole start` to `/path/to/shlink/vendor/bin/laminas mezzio:swoole:start`
 * The `GET /{shortCode}/qr-code/{size}` url has been removed. Use `GET /{shortCode}/qr-code?size={size}` instead.
+* Regular swoole extension is no longer supported. Use openswoole instead, as a direct replacement. In most of the cases you just need to uninstall one and install the other, the rest is transparent.
 
 ## From v1.x to v2.x