Import Troubleshooting (Fix Common Issues)

Estimated reading: 2 minutes 45 views

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

CONTENTS