Troubleshooting

Common Issues and Solutions

Import Issues

No content extracted

• Check CSS selectors match the source page
• Try enabling Auto Detect mode
• View page source to verify content structure
• Test selectors in browser Developer Tools

Import times out

• Increase PHP max_execution_time
• Reduce batch size for sitemap imports
• Increase request timeout in settings

403/404 errors when fetching URLs

• Change User Agent to standard browser string
• Check if URL is publicly accessible
• Verify your server can make outgoing requests
• Check if website blocks your IP or region

Image Issues

Images not downloading

• Verify source images are accessible
• Check image folder permissions (should be writable)
• Increase PHP memory_limit for large images

WebP conversion fails

• Verify GD extension has WebP support: gd_info()
• Check PHP version (8.1+ recommended)
• Images will use original format as fallback

General Issues

Component not accessible

• Clear Joomla cache
• Verify component is installed and enabled
• Check user permissions

AJAX errors during import

• Check browser console for JavaScript errors
• Verify session hasn't expired
• Check for security extension conflicts (RSFirewall, etc.)

Getting Help

If issues persist:

• Check Joomla error logs
• Review import logs for specific error messages
• Contact support with detailed error information
• Include Joomla, PHP versions, and error screenshots