Troubleshooting Guide - Instagram Unfollow Tracker

Common Issues & Solutions

Upload Issues

“No data found” Error

Problem: The app shows “No data found” after uploading your ZIP file.

Solutions:

Check file format: Ensure you downloaded JSON format (not HTML)
Verify data selection: Confirm you selected “Followers and Following” section

Check file structure: Your ZIP should contain files like:

connections/followers_and_following/
├── following.json
├── followers_1.json
└── followers_2.json (if you have many followers)

Try sample data: Click “Load sample” to test if the app works
Re-download data: Request a new export from Instagram

“Invalid file format” Error

Problem: The app rejects your ZIP file.

Solutions:

Check file extension: Ensure the file ends with .zip
Verify file integrity: Try re-downloading the ZIP from Instagram
Check file size: Very large files (>100MB) may cause issues
Browser compatibility: Try a different browser (Chrome recommended)

Upload takes too long

Problem: The upload process seems to hang or take forever.

Solutions:

Check file size: Large files (20k+ accounts) may take 5-10 seconds
Close other tabs: Free up browser memory
Use desktop browser: Mobile browsers may be slower
Check internet connection: Ensure stable connection for initial page load

Processing Issues

Slow processing

Problem: The app takes a long time to process your data.

Solutions:

Account size: Large accounts (10k+ followers) naturally take longer
Browser performance: Use Chrome or Firefox for best performance
Close other tabs: Free up memory and CPU resources
Wait patiently: Processing 50k accounts can take up to 10 seconds

“Out of memory” Error

Problem: Browser runs out of memory during processing.

Solutions:

Close other tabs: Free up browser memory
Restart browser: Clear memory and try again
Use desktop: Desktop browsers have more memory
Split data: If possible, use a smaller date range for export

Incomplete results

Problem: Some accounts are missing from the results.

Solutions:

Check export completeness: Ensure you selected “All time” date range
Verify file structure: Check that all follower files are present
Account status: Some accounts may have been deleted or made private
Export timing: The data is a snapshot from when you requested it

Display Issues

Accounts not showing

Problem: Expected accounts don’t appear in the results.

Solutions:

Check filters: Ensure no filters are hiding the accounts
Clear search: Make sure search box is empty
Check all badges: Look in different badge categories
Account status: Accounts may be in different categories than expected

Incorrect counts

Problem: The numbers don’t match what you see in Instagram.

Solutions:

Export timing: Instagram data changes constantly
Account changes: Accounts may have been deleted or made private
Data snapshot: The export shows the state when you requested it
Instagram updates: Live Instagram data may differ from export

UI not loading properly

Problem: The interface doesn’t display correctly.

Solutions:

Refresh page: Try reloading the page
Clear cache: Clear browser cache and cookies
Try different browser: Test in Chrome, Firefox, or Safari
Check JavaScript: Ensure JavaScript is enabled
Disable extensions: Try disabling browser extensions

Browser-Specific Issues

Chrome Issues

Problem: App doesn’t work properly in Chrome.

Solutions:

Update Chrome: Ensure you’re using Chrome 90+
Clear cache: Clear browsing data
Disable extensions: Try incognito mode
Check settings: Ensure JavaScript is enabled

Firefox Issues

Problem: App doesn’t work properly in Firefox.

Solutions:

Update Firefox: Ensure you’re using Firefox 88+
Clear cache: Clear browsing data
Disable extensions: Try private browsing mode
Check settings: Ensure JavaScript is enabled

Safari Issues

Problem: App doesn’t work properly in Safari.

Solutions:

Update Safari: Ensure you’re using Safari 14+
Clear cache: Clear browsing data
Check settings: Ensure JavaScript is enabled
Try Chrome: Safari may have compatibility issues

Mobile Browser Issues

Problem: App doesn’t work well on mobile.

Solutions:

Use desktop: Mobile browsers have limitations
Try Chrome Mobile: Best mobile browser support
Check memory: Close other apps to free up memory
Wait longer: Mobile processing may be slower

Data Issues

Missing follower files

Problem: Some follower files are missing from the export.

Solutions:

Check export settings: Ensure you selected “All time” date range
Re-request export: Request a new export from Instagram
Contact Instagram: If files are consistently missing
Check file names: Instagram may use different naming conventions

Corrupted data

Problem: The app shows errors when processing data.

Solutions:

Re-download: Get a fresh export from Instagram
Check file integrity: Ensure the ZIP file isn’t corrupted
Try different browser: Test in another browser
Report issue: File a bug report with details

Unexpected data format

Problem: The app can’t parse your data format.

Solutions:

Check format: Ensure you selected JSON format
Check date range: Use “All time” for complete data
Check selection: Only select “Followers and Following”
Report issue: File a bug report with sample data

Getting Help

When to Report Issues

Report issues if:

The app crashes or shows errors
Data is clearly incorrect
The interface doesn’t work properly
You’ve tried all troubleshooting steps

How to Report Issues

GitHub Issues: Create an issue
Include details:
- Browser and version
- Operating system
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if helpful

What Information to Include

Browser: Chrome 95, Firefox 94, etc.
OS: Windows 11, macOS 12, etc.
Account size: Approximate number of followers/following
Error messages: Exact error text
Steps: What you did before the issue occurred

Community Support

GitHub Discussions: Ask questions
FAQ: Check Frequently Asked Questions
User Guide: See User Guide

Prevention Tips

Best Practices

Use recent exports: Download fresh data for accurate results
Complete data: Select “All time” when downloading
JSON format: Always use JSON, not HTML
Desktop browser: Use Chrome or Firefox on desktop
Close other tabs: Free up memory for better performance

Regular Maintenance

Clear browser cache: Regularly clear browsing data
Update browser: Keep your browser updated
Check extensions: Disable problematic extensions
Monitor memory: Close unused tabs and applications

This troubleshooting guide is regularly updated based on user feedback and common issues. If you don’t find your issue here, please report it so we can help you and improve the guide.