diff --git a/CHANGELOG.md b/CHANGELOG.md
index a0c875d..405910e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,52 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v3.0.0] - 2022-07-26
+
+### Added
+
+-   PHP 8 support
+-   Laravel 9 support
+-   Added tests via Pest
+
+### Changed
+
+-   Replace pragmarx/countries by petercoles/multilingual-country-list
+-   Throw validation error when uploading file fails
+-   Use correct variable for single file upload.
+-   Update docs structure
+
+### Removed
+
+-   Dropped PHP 7.4 and L8 constraints, since media package is broken for those versions for sqlite, which we use in tests
+
 ## [2.2.0] - 2021-12-23
 
 ### Added
 
-- Browser event is dispatched if form is submitted
-- Compatibility for Livewire v2 (together with v1)
+-   Browser event is dispatched if form is submitted
+-   Compatibility for Livewire v2 (together with v1)
 
 ### Changed
 
-- Default classes are now configurable
-- Updated documentation
+-   Default classes are now configurable
+-   Updated documentation
 
 ### Removed
 
-- Unnecessary `optional()` helpers are removed
+-   Unnecessary `optional()` helpers are removed
 
 ## [2.1.0] - 2021-07-08
 
 ### Added
 
-- Added Form generation commands
-- Added possibility to pass custom rule namespace instead of object.
+-   Added Form generation commands
+-   Added possibility to pass custom rule namespace instead of object.
 
 ## [2.0.3] - 2021-03-16
 
 ### Added
 
-- GDPR component
-- Spacer field
+-   GDPR component
+-   Spacer field
 
 ## [2.0.2] - 2021-02-04
 
 ### Added
 
-- Flash data and functions
+-   Flash data and functions
 
 ## [2.0.1] - 2021-01-25
 
 ### Added
 
-- beforeSave() in the submit logic
+-   beforeSave() in the submit logic
 
 ## [2.0.0] - 2020-10-14
 
-- Release the refactored version
+-   Release the refactored version
 
 ## [1.0.0] - 2020-08-18
 
-- Initial release
+-   Initial release
diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 0000000..44c3c2c
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,6 @@
+# UPGRADING
+
+## From v2 to v3
+
+We replaced pragmarx/countries by petercoles/multilingual-country-list, since pragmarx/countries was not compatible with Laravel 9.
+But if you have not overridden the country field or helpers nothing is needed for this upgrade.