diff --git a/docs/upgrading/upgrading_to_v0x.md b/docs/upgrading/upgrading_to_v0x.md
index e39a58d184..d5f861cf45 100644
--- a/docs/upgrading/upgrading_to_v0x.md
+++ b/docs/upgrading/upgrading_to_v0x.md
@@ -5,6 +5,14 @@ title: Upgrading to v0.x
 
 This page summarizes the breaking changes between Crawlee for Python zero-based versions.
 
+## Upgrading to v0.5
+
+This section summarizes the breaking changes between v0.4.x and v0.5.0.
+
+### BeautifulSoupParser
+- Renamed `BeautifulSoupParser` to `BeautifulSoupParserType`. Probably used only in type hints. Please replace previous usages of `BeautifulSoupParser` by `BeautifulSoupParserType`.
+- `BeautifulSoupParser` is now a new class that is used in refactored class `BeautifulSoupCrawler`.
+
 ## Upgrading to v0.4
 
 This section summarizes the breaking changes between v0.3.x and v0.4.0.