Facing issues with a source or the app? Follow these steps to troubleshoot and find solutions.
- Update Extensions: Check -> for updates, no pending updates should be present.
- Update App: Go to -> and tap Check for updates.
- Manual Series Refresh: Drag down to manually refresh problematic series.
- Test Other Series: Try different series from the same source.
- Update WebView: Ensure your WebView is current.
- Public WebView: Attempt opening series in public WebView. Wait for CAPTCHA or Cloudflare protection if needed.
- Change Connection: Switch networks (Wi-Fi, mobile data, VPN) and confirm IP change.
- Collaborative Check: Get others to replicate the error.
- Source Status: Verify the source's status in a browser.
- Retry Button: Look for a retry button on the series page.
- Advanced Settings: Under -> -> , try these options:
- Clear Cache
- Clear Cookies
- Clear Database
- DNS over HTTPS
- Download Issues: Delete the queue and retry downloads.
- Restart Aniyomi: Force close and reopen the app.
If none of these solutions help, try asking in our Discord server.
Check #anime-extension-status first to see if your issue is known. State your app version and the source, anime, and episode with the problem if it is not listed.
An extension update may fix your issue
Wait or check for an extension update if you have not already. There are no ETAs for updates.
If you're the only one facing a problem, you might be encountering Cloudflare protection, an IP ban, or other countermeasures set by website owners against programs like Aniyomi.
To minimize future issues:
- Avoid using downloads with the source.
- Reduce the number of series in your library from that source.
These are general guidelines as each site has its specific undisclosed limits and triggers.
When everyone experiences a problem, it could be with the extension or app:
- Check open issues for the app and/or extensions.
- Check closed issues (app/extensions) in case it's resolved but not yet released.
- If not found, create a new issue.
If the site itself is problematic, patience is the only solution until it becomes functional again.