Use this guide to troubleshoot common GameGoblin issues. For account-specific help, submit a request from Settings > Help > Submit a Support Request.
Connection Issues
The Connect button is disabled
- Confirm that the required fields are filled in.
- RetroAchievements requires both a username and a Web API key.
- Check whether you already have an account connected for that platform.
- If you are connecting a third distinct platform without Pro, complete the Pro access step first.
Steam says that my profile is private
Open Steam Privacy Settings and set both My Profile and Game details to Public. Return to GameGoblin and try the connection or sync again.
Steam sign-in was canceled
- Return to GameGoblin and choose the Steam sign-in action again.
- Complete the browser flow without closing the authentication window.
- On a newly installed device, wait briefly for associated-domain registration and retry.
- Confirm that the device can open Steam in Safari or the default browser.
PlayStation sign-in does not return to GameGoblin
- Finish the sign-in and consent flow in the system browser.
- Do not close the browser before the authorization completes.
- Cancel the attempt, return to GameGoblin, and choose Try Again.
- Make sure the device has a working network connection and can open PlayStation pages.
PlayStation sign-in uses the system browser. GameGoblin does not need your Sony password or passkey.
RetroAchievements says that the account could not be checked
- Confirm the username spelling.
- Copy a current Web API key from the RetroAchievements control panel.
- Remove leading or trailing spaces from the username and key.
- Do not paste the key into a support request.
Xbox sign-in fails
- Confirm that Microsoft sign-in works in the system browser.
- Retry from Settings > Accounts.
- Check that the device date and time are set automatically.
- If the saved account needs attention, use the displayed re-authentication action instead of disconnecting first.
Sync Issues
Data is not updating
- Open Settings > Sync and check the affected platform.
- Choose Sync Now or pull to refresh from the Library.
- Leave GameGoblin open while a long first sync runs.
- Check whether the provider reports a rate limit, privacy issue, or re-authentication request.
- Try again later if the provider is temporarily unavailable.
Do not disconnect an account just because a provider is temporarily unavailable. Disconnecting removes that platform's games and account data.
Sync says that details are awaiting
GameGoblin can import an account's game IDs before catalog or achievement details are available. Open Settings > Sync to see progress and awaiting-detail counts. Details can be delayed by provider rate limits, unavailable legacy statistics, missing catalog data, or a later enrichment pass.
Sync is taking a long time
- The first full library import can be much longer than a normal refresh.
- Steam achievement requests are paced to respect the shared provider quota.
- Xbox may check achievement details for the whole imported library.
- Wishlist catalog details may arrive in batches.
- Leave the app open when possible and allow the next foreground sync to resume pending work.
Settings shows Needs attention
Needs attention is reserved for a problem that can normally be fixed by you, such as a rejected credential, Steam privacy settings, a missing iCloud account, or an iCloud setup problem. Open the affected Accounts or Sync page for the recovery action.
iCloud and Multiple Devices
My second device is not showing the library
- Confirm both devices use the same Apple Account.
- Confirm iCloud is available and the app has been opened on both devices.
- Unlock a device after restarting it and allow synchronization time.
- Check Settings > Sync for an iCloud account or setup warning.
- Do not use Disconnect unless you intend to remove the platform from all synchronized devices.
My saved layout or filter did not arrive yet
Library, Home, Game Detail, and supported sort/filter preferences use iCloud synchronization. Keep both devices online and open GameGoblin. Device-local settings such as automatic refresh cadence and release-reminder enablement do not move between devices.
Library and Wishlist Issues
A played game did not move to Now Playing
- Confirm the provider has recorded the play activity.
- Run a manual sync after the activity appears on the provider.
- Check whether the game is already Done. Done games do not regress to Now Playing.
- Check whether the game is Ignored. Restore it to show it in its lifecycle section.
A completed game did not move to Done
- Open the game and check whether the achievement or trophy total is complete.
- Confirm that all required groups, including PlayStation add-on groups, are complete.
- Check whether completion automation was disabled by a previous manual move out of Done.
- Refresh the game and run another sync if the provider recently changed the set.
Steam Wishlist is empty or unavailable
Steam Wishlist data must be publicly visible. Check the Steam privacy settings for the Wishlist, make it visible, and sync again. A private or unavailable wishlist is not treated as a successful empty wishlist.
Wishlist removal did not remove the item
GameGoblin changes Wishlist membership only after a successful provider mirror. Check the provider first, run Sync Now, and review the Wishlist phase in Settings. A game that is Now Playing or Done remains in the library even after its Wishlist membership is removed.
Release date or reminder is missing
- Only a confirmed future calendar date qualifies for a reminder.
- Year-only, missing, or Coming soon dates remain Unreleased and do not schedule a reminder.
- Release reminders require GameGoblin Pro, notification permission, and the local Settings toggle.
- Only visible Wishlist games qualify, and the nearest 60 eligible releases are scheduled.
Achievements and Guides
A game has no achievements
Not every provider title exposes achievements, and some older or legacy games may return no usable statistics. GameGoblin can record a successful empty result and keep the catalog game in your library.
A guide picker has no results
Guide availability depends on the provider site and the exact game identity. Try the game's custom guide URL action if the native picker is empty, or paste a guide link directly.
GameGoblin Pro Issues
Pro features are still locked
- Wait briefly for the purchase status to refresh.
- Open Settings and choose Restore Purchases when available.
- Confirm that the device uses the Apple Account associated with the purchase.
- Retry the feature after the GameGoblin Pro status becomes active.
My settings changed after Pro access ended
Saved Pro preferences are retained. While access is inactive or unknown, GameGoblin shows the default presentation and does not delete the saved layout. Reactivating Pro restores it.
Widgets
The widget shows a lock
Live widget content requires active GameGoblin Pro access. Open GameGoblin to refresh entitlement status. Widget selector previews remain available without Pro.
The widget is stale
Open GameGoblin and allow it to prepare a new snapshot. Widgets do not run provider synchronization or network image loading on their own.
Still Need Help?
Submit a support request from GameGoblin Settings and include:
- A description of the issue
- Steps to reproduce it
- The affected provider and game, if relevant
- Your iPhone, iPad, or Mac model and OS version
- Your GameGoblin version
- The sync phase or error message shown
Never include passwords, passkeys, API keys, refresh tokens, or private account data in a support request.