diff --git a/docs/USER-DOCUMENTATION.md b/docs/USER-DOCUMENTATION.md
index 3274b2029d..8193b47c5b 100644
--- a/docs/USER-DOCUMENTATION.md
+++ b/docs/USER-DOCUMENTATION.md
@@ -86,17 +86,15 @@ you want to learn more.
 Running on Wayland
 ------------------
 
-Electron is based on Gtk2, which can't run natively on Wayland. Fortunately,
-the [XWayland Server][xwayland] provides backwards compatibility to run *any* X
-client on Wayland, including Etcher.
-
-This usually works out of the box on mainstream GNU/Linux distributions that
-properly support Wayland. If it doesn't, make sure the `xwayland.so` module is
-being loaded by declaring it in your [weston.ini]:
+You can run Etcher on Wayland by passing command line flags like so:
 
+```sh
+balena-etcher --enable-features=WaylandWindowDecorations --ozone-platform=wayland
 ```
-[core]
-modules=xwayland.so
+To make these changes permanent to the desktop entry, run these commands in your terminal:
+```sh
+cp /usr/share/applications/balena-etcher.desktop ~/.local/share/applications
+sed -i 's|^Exec=/opt/balenaEtcher/balena-etcher %U$|Exec=/opt/balenaEtcher/balena-etcher --enable-features=WaylandWindowDecorations --ozone-platform=wayland %U|' ~/.local/share/applications/balena-etcher.desktop
 ```
 
 Runtime GNU/Linux dependencies
@@ -224,4 +222,4 @@ macOS 10.10 (Yosemite) and newer versions][electron-supported-platforms].
 [windows-iot-dashboard]: https://developer.microsoft.com/en-us/windows/iot/downloads
 [woeusb]: https://github.com/slacka/WoeUSB
 
-See [PUBLISHING](/docs/PUBLISHING.md) for more details about release types.
\ No newline at end of file
+See [PUBLISHING](/docs/PUBLISHING.md) for more details about release types.