If RetroAchievements is not working in RetroArch, the problem usually comes down to one of five things: an unverified account, an expired login, an unsupported emulator core, an unrecognized game file, or a Hardcore Mode conflict. The good news is that you can check each one without changing your entire handheld setup.
This guide walks through the fixes in the order that makes the most sense. You will also learn how to tell whether achievements are actually active before spending an hour on a challenge that will never register.
Start with the quick RetroAchievements checklist
Before adjusting advanced settings, check the basics:
- Your device has a working internet connection.
- Your RetroAchievements account exists and its email address has been verified.
- Achievements are enabled in RetroArch.
- Your username and password are entered correctly.
- The game has an achievement set and your particular version is supported.
- Your selected core supports RetroAchievements.
- Hardcore Mode is not conflicting with cheats, save states, or unsupported features.
Launch a game after checking those items. A successful connection should display an achievement notification or make the achievement list available from the Quick Menu.
1. Enable achievements and verify your account
RetroAchievements is a separate community service, not an account automatically included with RetroArch. Create an account on the official RetroAchievements website, confirm the registration email, and then open Settings → Achievements inside RetroArch.
Turn on Achievements and enter your login details. Menu labels can vary slightly between RetroArch versions and handheld firmware, but the achievements section is normally under Settings. On some builds, account credentials are also accessible through Settings → User → Accounts → RetroAchievements.
After signing in, completely close the current game and launch it again. Enabling achievements after content has already started does not always initialize the session correctly.
2. Fix login errors and expired authentication
If RetroAchievements worked yesterday but suddenly reports a login failure, your saved authentication token may have expired. This can happen even when you have not changed your password.
- Open the RetroAchievements account or achievements settings.
- Clear the saved username and password.
- Enter both details again carefully.
- Restart RetroArch and reload a supported game.
If login details disappear after every restart, the problem may be configuration storage rather than your account. Our guide to fixing RetroArch settings that will not save explains read-only storage, configuration files, and save-on-exit behavior.
Also check your device clock. A wildly incorrect date or time can interfere with secure network connections on some systems.
3. Confirm that your handheld is actually online
RetroAchievements needs an internet connection to authenticate your account and identify the game when a session begins. A Wi-Fi symbol alone does not guarantee that the device can reach the service.
Reconnect to Wi-Fi, check whether another network-dependent feature works, and restart the handheld if the connection looks stuck. Public networks that require a browser sign-in can be especially troublesome for dedicated gaming devices.
If your connection drops while you are playing, RetroArch may temporarily cache an earned achievement for the current session. Reconnect before closing the game; quitting first can prevent that pending unlock from reaching the service.
4. Use a core that officially supports achievements
A game can run perfectly while its achievements fail because the emulator core does not expose the memory data required by RetroAchievements. Support depends on the specific core, not just the console being emulated.
For example, two different cores can both launch the same Super Nintendo game, yet only one may be officially supported or fully compatible with a newer achievement set. Check the current emulator support information from RetroAchievements, then switch to a supported core for your system.
If you are unsure how cores differ from playlists or settings, start with our beginner’s guide to RetroArch cores, content, and playlists.
When RetroArch says some achievements are unsupported, update both RetroArch and the selected core where your firmware allows it. Older versions may not support newer achievement logic or expose all required memory regions.
5. Check whether your exact game version is recognized
RetroAchievements identifies games using a hash: a digital fingerprint associated with a particular game version. The title shown in your playlist is not enough. A different region, revision, translation patch, ROM hack, or modified file may produce a hash that is not linked to the achievement set.
To inspect the current game, open Quick Menu → Information and look for RetroAchievements Hash. Compare the result with the supported game hashes listed on the game’s official RetroAchievements page.
If the hash is missing or unsupported, use a legally obtained version that matches one of the listed supported hashes. Avoid downloading copyrighted game files from unlicensed sources.
For arcade systems, file naming can also matter because some identification methods use the archive name. If your games are missing from RetroArch entirely, solve that first with our guide to RetroArch playlists that are not showing games.
6. Understand what Hardcore Mode disables
Hardcore Mode awards separate recognition for playing without certain emulator conveniences. When enabled, it restricts features such as save states, slow motion, and cheats. Some unsupported cores or core-specific options can also prevent a valid Hardcore session.
If your normal save-state hotkeys suddenly stop working, that may be expected behavior rather than a broken controller. Our explanation of save files versus save states covers why regular in-game saves remain different from emulator snapshots.
Choose the mode that matches how you want to play:
- Hardcore Mode: stricter rules, separate recognition, and restricted emulator assistance.
- Casual mode: greater flexibility, including access to features that Hardcore disables.
If Hardcore refuses to activate, disable cheats, remove incompatible core options, select a supported core, and restart the game. Arcade cores can have additional restrictions involving cheat-enabled BIOS or patched sets.
7. Look for achievements in the Quick Menu
The most reliable basic check is to open a game and then open Quick Menu → Achievements. If the session is working, you should see the available achievement list or progress information.
If the section is empty, missing, or reports that the game is unidentified, work backward through account login, internet access, core compatibility, and game hash. Do not assume that a startup notification alone means every achievement is eligible.
If opening the Quick Menu itself is confusing, our RetroArch hotkeys guide explains menu shortcuts and common controller combinations.
8. Fix achievements that should unlock but do not
First, reread the exact achievement description. Some challenges require a specific character, difficulty, location, or uninterrupted sequence. Then verify that the achievement is active in the current game session.
If you are playing in casual mode, loading a save state can sometimes interfere with how an achievement tracks earlier conditions, especially with older software. Try restarting from an in-game save and meeting the requirements again.
Update RetroArch and your supported core, confirm the correct game hash, and check your connection before reporting a broken achievement. If the problem persists, use the reporting options on the official RetroAchievements website and include your emulator version, core, game version, and steps to reproduce the issue.
A simple troubleshooting order that works
- Verify your account and enable achievements.
- Reconnect the device to the internet.
- Clear and re-enter your login if authentication fails.
- Update RetroArch and select an officially supported core.
- Compare your game hash with the supported versions.
- Disable conflicting cheats or change Hardcore Mode.
- Reload the game and inspect the Quick Menu achievement list.
Most RetroAchievements problems disappear once the account, core, and game version all match what the service expects. Change one item at a time so you know which fix actually solved the issue.
