diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70a87a4420e4e811d9f217bcf5e0f1f668e3297a..98aae6a5a35387bd9719ea496c55a3f362b56bdf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,16 @@
+# [3.1.0](https://gitlab.com/to-be-continuous/sonar/compare/3.0.0...3.1.0) (2022-08-10)
+
+
+### Features
+
+* add wait for quality gate option ([1c4c9cc](https://gitlab.com/to-be-continuous/sonar/commit/1c4c9ccf1abe0db8033813cc0d2f8d997d03b00e))
+* manage separate $SONAR_PROJECT_KEY and $SONAR_PROJECT_NAME ([a0e34f4](https://gitlab.com/to-be-continuous/sonar/commit/a0e34f49762d8ada95c261e5c8df014f394de1f2))
+* manage Sonar task cache in GitLab ([c44a43d](https://gitlab.com/to-be-continuous/sonar/commit/c44a43d575c8a81abe972b30aeca5038bb39e0a6))
+* migrate $SONAR_AUTH_TOKEN to $SONAR_TOKEN (standard) ([feb5ceb](https://gitlab.com/to-be-continuous/sonar/commit/feb5ceb2c6356586e5d9b32cdc874733b14bc667))
+* migrate $SONAR_URL to $SONAR_HOST_URL (standard) ([4abffcf](https://gitlab.com/to-be-continuous/sonar/commit/4abffcf78a9469cd72a8c8536ba5d096cd99986a))
+* remove explicit MR analysis ([6a6d28b](https://gitlab.com/to-be-continuous/sonar/commit/6a6d28b840574307ff3d190ed7465f9f5540c3b8))
+* remove support of Sonar GitLab plugin (discontinued) ([7e93a03](https://gitlab.com/to-be-continuous/sonar/commit/7e93a031d68ebfc1fc7f0095a0253ca5edc98dc3))
+
 # [3.0.0](https://gitlab.com/to-be-continuous/sonar/compare/2.1.0...3.0.0) (2022-08-05)
 
 
diff --git a/README.md b/README.md
index 4246e2d0f468ed931f5f06b6b27a7b527d57c419..46780ed68a44fa58014758d5dee97de3bcb588a0 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ In order to include this template in your project, add the following to your `gi
 ```yaml
 include:
   - project: 'to-be-continuous/sonar'
-    ref: '3.0.0'
+    ref: '3.1.0'
     file: '/templates/gitlab-ci-sonar.yml'
 ```
 
diff --git a/templates/gitlab-ci-sonar.yml b/templates/gitlab-ci-sonar.yml
index 5df42b0bc87b2fb9b7e9137829d3e55b5da859fc..73fcc891a4d3244a9e08885c86770a455bf02173 100644
--- a/templates/gitlab-ci-sonar.yml
+++ b/templates/gitlab-ci-sonar.yml
@@ -262,7 +262,7 @@ sonar:
     entrypoint: [""]
   services:
     - name: "$TBC_TRACKING_IMAGE"
-      command: ["--service", "sonar", "3.0.0" ]
+      command: ["--service", "sonar", "3.1.0" ]
   variables:
     # see: https://docs.sonarqube.org/latest/analysis/gitlab-integration/#header-4
     SONAR_USER_HOME: "${CI_PROJECT_DIR}/.sonar" # Defines the location of the analysis task cache