🔧 Troubleshooting & Common Issues

Scanning Issues

”No assets found” after scanning

• Make sure your place has assets with references (decals, sounds, animations, meshes)
• Try switching to Script Mode (Flow Max) if assets are loaded dynamically
• Check that your .ROBLOSECURITY cookie is valid and not expired

Scan hangs or takes forever

• Large places with many scripts can take longer
• Try the Instances only mode instead of Scripts
• Restart AssetFlow and try again
• Check your internet connection

Plugin shows “Disconnected”

1. Make sure AssetFlow desktop app is running
2. In the plugin, click Reconnect
3. If still disconnected, restart Roblox Studio
4. Reinstall the plugin from the Creator Store

Upload Issues

”API key required” when trying to upload

• You need an Open Cloud API key configured in Accounts
• Go to the Roblox Creator Dashboard  to create one
• Make sure it includes asset:read, asset:write, and asset-permissions:write scopes

Upload fails with “403 Forbidden”

• Your API key may be missing the required scopes
• If uploading to a group, the key needs group-scoped permissions
• Your key may have expired — create a new one

Upload is very slow

• Flow tier: 8 concurrent uploads (Normal mode)
• Flow+/Flow Max: Fast Mode with 15 concurrent uploads
• Enable Fast Mode in the Configure & Reupload modal
• The Flow tier only has Normal mode; Flow+/Flow Max can toggle between Normal and Fast

”Asset already exists” error

• Enable Skip Owned Assets in Settings to avoid reuploading what you already have
• Or just skip that specific asset in the selection

Account Issues

Cookie expired

.ROBLOSECURITY cookies expire after a period of inactivity. To refresh:

1. Log in to roblox.com in your browser
2. Copy the new .ROBLOSECURITY cookie
3. Update it in AssetFlow’s Accounts page

API Key not working

• Verify the key has the correct scopes
• Make sure your User ID matches the key’s owner
• Test the key using the Test button in Accounts
• Create a new key if needed

Application Issues

App won’t start

• Check that no other instance of AssetFlow is running
• Try running as Administrator
• Check the Windows Event Viewer for crash logs
• Reinstall the latest version from the website

UI is glitchy or not rendering

• Toggle dark/light mode (if available)
• Restart the application
• Update your graphics drivers

Can’t find a feature

• Check the navigation sidebar on the left
• Some features are tier-limited (Script Mode = Flow Max, Group Upload = Flow+)
• If you believe a feature should be available, share the details in the AssetFlow Discord so the team can investigate

Still Stuck?

If none of these solutions help:

1. Join the AssetFlow Discord 
2. Go to the #support channel
3. Include:
   • A screenshot of the issue
   • Your current app version (shown in the title bar)
   • What you were trying to do
   • Any error messages you saw