diff --git a/srcpkgs/qtile/INSTALL.msg b/srcpkgs/qtile/INSTALL.msg
new file mode 100644
index 00000000000..95c75c2e656
--- /dev/null
+++ b/srcpkgs/qtile/INSTALL.msg
@@ -0,0 +1,9 @@
+!!! Config breakage !!!
+    - lazy.qtile.display_kb() no longer receives any arguments. If you passed
+      it any arguments (which were ignored previously), remove them.
+    - If you have a custom startup Python script that you use instead of
+      "qtile start" and run init_log manually, the signature has changed.
+      Please check the source for the updated arguments.
+    - "KeyChord"'s signature has changed. "mode" is now a boolean to indicate
+       whether the mode should persist. The "name" parameter should be used
+       to name the chord (e.g. for the ``Chord`` widget).
diff --git a/srcpkgs/qtile/template b/srcpkgs/qtile/template
index cb576079af5..8595044b387 100644
--- a/srcpkgs/qtile/template
+++ b/srcpkgs/qtile/template
@@ -1,7 +1,7 @@
 # Template file for 'qtile'
 pkgname=qtile
-version=0.21.0
-revision=2
+version=0.22.0
+revision=1
 build_style=python3-pep517
 hostmakedepends="python3-setuptools_scm python3-cairocffi python3-xcffib python3-wheel pkg-config"
 makedepends="python3-devel libffi-devel pulseaudio-devel"
@@ -10,9 +10,9 @@ short_desc="Full-featured tiling window manager written and configured in Python
 maintainer="Kai Stian Olstad <void@olstad.com>"
 license="MIT"
 homepage="http://www.qtile.org/"
-changelog="https://raw.githubusercontent.com/qtile/qtile/v${version}/CHANGELOG"
+changelog="https://raw.githubusercontent.com/qtile/qtile/master/CHANGELOG"
 distfiles="${PYPI_SITE}/q/qtile/qtile-${version}.tar.gz"
-checksum=93e1f8216c669b5570333607d5d06de7d7f16033b0e73cf34c896459f2df5254
+checksum=ecec16cf41b6bbbc1847d0cd3f7dba68eb16fa175fbe856a229817297f605f6e
 
 post_install() {
 	vinstall resources/qtile.desktop 644 usr/share/xsessions