Troubleshooting
Common issues and how to resolve them.
Login Issues
"Magic link expired"
- Magic links are valid for 15 minutes
- Request a new link and use it immediately
- Check your spam folder if not received
"Passkey not recognized"
- Ensure you're using the same device/browser where the passkey was created
- Try using a magic link as backup
- Re-register your passkey in Settings → Security
"Can't log in on new device"
- Use magic link for first login on new devices
- Then add a new passkey for that device
Notebook Issues
"Text not extracted correctly"
- Take a clearer photo with better lighting
- Ensure document is flat and not wrinkled
- Try uploading a higher resolution image
- Handwritten text may have lower accuracy
"Upload failed"
- Check file size (maximum varies by plan)
- Supported formats: JPEG, PNG, PDF
- Check your internet connection
Form Issues
"Fields not detected"
- Manually add fields after upload
- Try uploading a cleaner scan of the document
- PDF works better than photos for complex forms
"Can't fill a shared form"
- Ensure you have "Fill" permission (not just "View")
- Contact the form owner to update permissions
"Form submission failed"
- Required fields may be missing
- Check for validation errors on each field
- Try refreshing the page and re-submitting
Secrets Vault Issues
"Vault won't unlock"
- Double-check your master password
- Master password is case-sensitive
- If forgotten, use your recovery key at
/vault/recovery
"Lost recovery key"
- Without recovery key, Tier 2 secrets cannot be recovered
- This is by design for security
- You'll need to create a new vault and re-add secrets
"Secret not showing in automation"
- Ensure the secret is bound to the automation
- Check that the placeholder name matches exactly
- Tier 2 secrets require vault to be unlocked
Automation Issues
"Automation won't start"
- Desktop app must be running
- Check that you're logged into the same account
- Try restarting the desktop app
"Element not found"
- The page layout may have changed
- Use browser DevTools to get the current selector
- Add a Wait step before the failing step
- Try using a different selector type (CSS vs XPath vs Text)
"Timeout error"
- Increase the timeout for slow-loading pages
- Check your internet connection
- The target website may be down
"Login automation fails"
- Verify secret values are correct
- Some sites have bot detection - try adding random delays
- CAPTCHAs require manual intervention
"Automation works sometimes, fails other times"
- Add explicit Wait steps for dynamic content
- Increase timeouts
- The page may load differently each time
Desktop App Issues
"App won't connect"
- Check your internet connection
- Try logging out and back in
- Check if firewall is blocking the app
"Automations not syncing"
- Ensure you're logged into the same account on web and desktop
- Try refreshing: close and reopen the app
- Check for app updates
"Browser doesn't launch"
- Reinstall the desktop app to restore bundled browser
- Check system resources (RAM, disk space)
Mobile Issues
"Dispatch to desktop not working"
- Ensure desktop app is running on your computer
- Both devices must be logged into the same account
- Check internet connection on both devices
"Camera not working for notebook capture"
- Grant camera permissions in browser/app settings
- Try using the file upload option instead
General Tips
- Refresh the page - Many issues resolve with a simple refresh
- Clear browser cache - Cached data can cause unexpected behavior
- Check browser console - Press F12 to see detailed error messages
- Try a different browser - Some features work better in Chrome/Edge
- Check system time - Incorrect device time can cause authentication issues
Still Need Help?
- AI Assistant: Describe your issue in natural language
- Support Tickets: Create a ticket for complex issues
When creating a support ticket, include:
- What you were trying to do
- What happened instead
- Any error messages you saw
- Browser and device information
Need More Help?