Flatpak Apps Missing From System Menu: Proven Fix (2026)

Flatpak apps missing from system menu is a common issue after installing Flatpak applications on Linux. You install an app, but it does not appear in your desktop environment’s application menu.

When flatpak apps missing from system menu occurs, you cannot launch the application from the graphical interface. This proven guide provides effective methods to restore missing launcher entries and integrate Flatpak applications into your system menu on GNOME, KDE, and other desktop environments.

1. Root Cause

When flatpak apps missing from system menu occurs, the desktop environment has not recognized the newly installed Flatpak application. Flatpak applications install desktop entry files (.desktop) in standard locations, but the system may not refresh its menu cache.

The most common cause is that the desktop environment’s menu cache is outdated. When you install a Flatpak application, the system does not automatically update the menu cache in all desktop environments. According to the official Flatpak documentation, applications are installed with their desktop files included, but the desktop environment must be notified of the changes.

Another frequent cause is that the application’s desktop file is located in a directory that is not scanned by your desktop environment. Flatpak desktop files are typically placed in /var/lib/flatpak/exports/share/applications/ (system-wide) or ~/.local/share/flatpak/exports/share/applications/ (user-specific). The Arch Linux Wiki confirms that these paths must be included in the desktop environment’s search path.

Permissions issues can also prevent desktop files from being displayed. If the desktop file is not readable by your user account, it will not appear in the menu. Understanding these root causes helps you choose the right fix.

2. Restart Your Desktop Session

The simplest fix for flatpak apps missing from system menu is to log out and log back in. This refreshes the desktop environment’s menu cache.

Log out → Log back in → Check application menu

If you are using GNOME, you can also restart GNOME Shell without logging out. Press Alt+F2, type r, and press Enter. This restarts the shell and refreshes the menu. For KDE Plasma, use kquitapp5 plasmashell && kstart5 plasmashell in a terminal.

Outcome: Restarting the desktop session resolves the flatpak apps missing from system menu issue in many cases.

3. Manually Update the Desktop Database

Updating the desktop database manually can resolve flatpak apps missing from system menu. This command updates the cache used by the system menu.

sudo update-desktop-database

This command rebuilds the desktop file database cache. It is available on most Linux distributions. If this does not work, you may need to use distribution-specific commands like xdg-desktop-menu forceupdate or gtk-update-icon-cache.

Outcome: Updating the desktop database resolves the flatpak apps missing from system menu issue.

4. Reload the Flatpak Application Database

Flatpak maintains its own application database. Reloading it can fix flatpak apps missing from system menu.

flatpak update --appstream
flatpak update

The --appstream flag updates the application metadata. This refreshes the list of available applications and their desktop entries. After running this, check the system menu again.

Outcome: Reloading the Flatpak database resolves the flatpak apps missing from system menu issue.

5. Check and Repair Desktop Files

Corrupted or incorrectly installed desktop files can cause flatpak apps missing from system menu. Verify the desktop file exists and is valid.

ls -la ~/.local/share/applications/*.desktop
ls -la /usr/share/applications/*.desktop

Flatpak applications store their desktop files in /var/lib/flatpak/exports/share/applications/ or ~/.local/share/flatpak/exports/share/applications/. Check if the desktop file exists. If it is missing, reinstall the application. You can also validate the desktop file with desktop-file-validate.

Outcome: Checking and repairing desktop files resolves the flatpak apps missing from system menu issue.

6. Reinstall the Missing Application

Reinstalling the application can resolve flatpak apps missing from system menu by ensuring all files are correctly placed.

flatpak uninstall <app-id>
flatpak install <app-id>

First, uninstall the application using its application ID. Then reinstall it. This forces Flatpak to recreate the desktop file and integrate it with the system. After reinstalling, restart your desktop session.

Outcome: Reinstalling the application resolves the flatpak apps missing from system menu issue.

7. Check Flatpak Installation Paths

The desktop environment must scan the correct directories for Flatpak desktop files. Verify these paths are included to resolve flatpak apps missing from system menu.

echo $XDG_DATA_DIRS
# Should include /var/lib/flatpak/exports/share
# and /usr/share

Flatpak installation paths are typically included in XDG_DATA_DIRS. If they are missing, add them. You can add them to /etc/profile or ~/.profile. The GNOME documentation confirms that these paths must be in the environment.

Outcome: Verifying installation paths resolves the flatpak apps missing from system menu issue.

8. Verify Environment Variables

Environment variables can affect flatpak apps missing from system menu. Ensure that XDG_DATA_DIRS is correctly set.

export XDG_DATA_DIRS="$XDG_DATA_DIRS:/var/lib/flatpak/exports/share:/home/$USER/.local/share/flatpak/exports/share"

Add this to your ~/.bashrc or ~/.profile for persistence. After making changes, log out and log back in.

Outcome: Setting environment variables resolves the flatpak apps missing from system menu issue.

9. Create a Custom Desktop Entry Manually

If all else fails, creating a custom desktop entry manually can resolve flatpak apps missing from system menu.

nano ~/.local/share/applications/custom-app.desktop

Add the following content:

[Desktop Entry]
Type=Application
Name=My App
Exec=flatpak run <app-id>
Icon=app-icon-name
Categories=Utility;

Replace <app-id> with the actual Flatpak application ID. You can find the application ID with flatpak list. Save the file and run update-desktop-database.

Outcome: Creating a custom desktop entry resolves the flatpak apps missing from system menu issue.

10. Advanced: Inspect Flatpak Permissions

For advanced users, checking Flatpak permissions can help diagnose flatpak apps missing from system menu.

flatpak override --show <app-id>
flatpak info <app-id>

If the application has restricted permissions that prevent it from creating desktop entries, you may need to adjust them. Use flatpak override --user --filesystem=~/.local/share/applications <app-id> if needed.

Outcome: Inspecting and adjusting permissions resolves the flatpak apps missing from system menu issue.

11. Frequently Asked Questions

Why are Flatpak apps not showing in my system menu?

This is usually caused by an outdated menu cache, incorrect environment variables, or missing desktop files.

How do I restart GNOME Shell to fix missing apps?

Press Alt+F2, type r, and press Enter. This restarts the shell without logging out.

How do I update the desktop database?

Run sudo update-desktop-database to rebuild the system menu cache.

Where are Flatpak desktop files stored?

System-wide installations store desktop files in /var/lib/flatpak/exports/share/applications/. User installations store them in ~/.local/share/flatpak/exports/share/applications/.

Can I manually create a desktop entry for a Flatpak app?

Yes, create a .desktop file in ~/.local/share/applications/ with Exec=flatpak run <app-id>.

Does logging out and logging back in fix the issue?

Often yes. This refreshes the menu cache and loads new desktop entries.

What is XDG_DATA_DIRS?

XDG_DATA_DIRS is an environment variable that lists directories where the system looks for data files, including desktop entries.

Can permissions prevent desktop entries from appearing?

Yes, if the desktop file is not readable or the application lacks permission to create it, it will not appear.

How do I reinstall a Flatpak app to fix missing entries?

Use flatpak uninstall <app-id> then flatpak install <app-id>. This recreates the desktop files.

What should I do if none of these methods work?

Check the flatpak run <app-id> command works in the terminal. If it does, use the custom desktop entry method.

12. Conclusion

The flatpak apps missing from system menu issue can be resolved with systematic troubleshooting. From restarting your desktop session to creating custom desktop entries, this proven guide covers all practical approaches. Start with the simplest method — logging out and back in — and escalate only if necessary. With this guide, you can overcome the flatpak apps missing from system menu problem and access your applications from the graphical interface.

For more Linux troubleshooting, explore our Linux Hub and guides on Linux command not found after installing package, Linux no sound after update, and NVIDIA screen tearing fix. With the right approach, you can resolve the flatpak apps missing from system menu issue and keep your system organized.