[websites/linux-kde-org] content/docs: cjkv-input: mention how to resolve compatibility issues

Git commit e29818d245de05a8e078d2c1bc668085ccaedccc by Nate Graham.
Committed on 25/07/2026 at 17:38.
Pushed by ngraham into branch 'master'.

cjkv-input: mention how to resolve compatibility issues

M  +37   -0    content/docs/cjkv-input.md

https://invent.kde.org/websites/linux-kde-org/-/commit/e29818d245de05a8e078d2c1bc668085ccaedccc

diff --git a/content/docs/cjkv-input.md b/content/docs/cjkv-input.md
index 085eaf7..aa78e8e 100644
--- a/content/docs/cjkv-input.md
+++ b/content/docs/cjkv-input.md
@@ -42,3 +42,40 @@ If you are prompted to change your system layout to match the input method, clic
 Type as expected.
 
 To type Latin characters instead of using the input method and, press <kbd>Ctrl</kbd>+<kbd>Space</kbd> while a text field is focused, or click the symbol for the active input method in the *System Tray*. Do the same thing a second time to return to using the input method.
+
+
+## Fixing compatibility issues
+Fcitx 5 works with almost all applications. However, manual steps may be needed to make it work with older software using the XWayland compatibility layer, such as Steam, Krita, and JetBrains IDEs.
+
+Such apps need special *environment variables* set in order to use Fcitx. Here’s how to do this for an app in which Fcitx 5 isn’t working:
+
+### Graphical
+1. Launch *System Settings*.
+2. In the sidebar on the left, scroll down and navigate to *Application Permissions*.
+3. Select the app for which Fcitx 5 isn’t working.
+4. Click “Flatpak Settings” in the top-right corner.
+5. Scroll down and click the arrow next to the section header text “Advanced Permissions”.
+6. Scroll down to the “Environment” group.
+7. Click the “Add New…” button.
+8. In the “Name” field, enter `XMODIFIERS`.
+9. In the “Value” field, enter `@im=fcitx`.
+
+Now repeat steps 7-9 for the following additional environment variables:
+- name: `GTK_IM_MODULE`; value: `xim`
+- name: `QT_IM_MODULE`; value: `xim`
+- name: `QT_IM_MODULES`; value: `wayland;fcitx;ibus`
+
+
+### Command-line
+Find the ID of the app you want to add environment variables to using <code>flatpak list</code> or *System Settings* > *Application Permissions* > [the app] > *Flatpak Settings* in the top-right corner > [In the right-most column, find the ID under its name].
+
+Then apply the necessary overrides:
+
+<pre>
+flatpak override --env=XMODIFIERS=@im=fcitx [app id]
+flatpak override --env=GTK_IM_MODULE=xim [app id]
+flatpak override --env=QT_IM_MODULE=xim [app id]
+flatpak override --env=QT_IM_MODULES='wayland;fcitx;ibus' [app id]
+</pre>
+
+(replace `[app id]` with the actual ID of the app, e.g. `com.valvesoftware.Steam`)