Import Troubleshooting (Fix Common Issues)

if you are facing issues while importing movies or TV series using TMDb, this guide will help you identify and fix common problems.

⚠️ Before You Start

Make sure your TMDb API is properly configured.

If you haven’t set it up yet, please follow the Requirements & TMDb API Setup guide.

👉 (Replace # with your actual doc URL)

❌ TMDb Import Not Working

Possible Causes:

• Invalid or missing API key
• API key not saved correctly
• Server blocking external requests

Solution:

• Go to Settings → API Settings
• Verify your API key
• Re-save settings
• Ensure your hosting allows external API requests

❌ No Results Found

Possible Causes:

• Incorrect movie or TV series name
• Typo in search query
• Content not available in TMDb

Solution:

• Double-check spelling
• Try using the TMDb ID (recommended)
• Search directly on the TMDb website to confirm availability

❌ Data Not Fully Imported

Possible Causes:

• Missing data in the TMDb database
• Partial API response

Solution:

• Manually update missing fields
• Add taxonomies, images, or cast manually if needed

❌ Images Not Loading

Possible Causes:

• Server blocking external images
• SSL or permission issues
• Slow network or timeout

Solution:

• Check server permissions
• Ensure HTTPS is configured correctly
• Try re-importing the content

❌ Cast & Crew Not Imported

Possible Causes:

• TMDb data limitation
• API response issue

Solution:

• Manually add cast from Cast & Crew Management
• Re-import using TMDb ID

❌ Import Button Not Responding

Possible Causes:

• JavaScript conflict
• Plugin/theme conflict
• Browser issue

Solution:

• Try another browser
• Disable other plugins temporarily
• Check the browser console for errors

❌ Bulk Import Slow or Stuck

Possible Causes:

• Server performance limitations
• Too many items in one batch

Solution:

• Import in smaller batches (10–20 items)
• Upgrade hosting if needed
• Wait for the process to complete

❌ Imported Content Missing Video

Important Note:

• TMDb does not provide video files

Solution:

• Manually add video sources after import
• Refer to the Video Player documentation