Check K2 is installed: Go to Extensions > Manage and search for "K2". It must be listed as a component.
Check K2 tables exist: MigrateK2 Pro looks for #__k2_items and #__k2_categories. If K2 was partially uninstalled, the tables may be missing.
Database prefix: The component uses Joomla's configured database prefix. If your prefix is non-standard, this is handled automatically.
Migration Stuck or Frozen
Check your browser console: Press F12 and look for JavaScript errors or failed network requests
PHP timeout: If your server has a very low max_execution_time, individual batches may time out. Increase it to at least 60 seconds.
Memory limit: Large articles with many images may require more memory. Set memory_limit to at least 128M.
Close and resume: Close the browser, return to the dashboard, and click Continue Migration. The system resumes from the last successful batch.
Duplicate Content After Re-Run
By design, this should not happen. Categories are checked by alias before creation, and articles are tracked in the mapping table.
If duplicates appear, run a Reset to clean everything, then run the migration again from scratch.
Images Not Migrated
Check media folder: Ensure media/k2/items/ exists and contains images
Check permissions: The target image folder (e.g., images/k2-migrated/) must be writable by the web server
Check the log: The migration log records warnings for each image that could not be copied
Custom Fields Missing
Check K2 extra fields: Only published extra fields (published = 1) are migrated
Verify in Joomla: Go to Content > Fields and Content > Field Groups to see migrated fields
Field values: Check individual articles in the editor — custom field values appear in the Fields tab
301 Redirects Not Working
Check com_redirect: Go to Components > Redirects and verify entries exist with "MigrateK2 Pro" in the comment column
Enable the redirect plugin: Go to Extensions > Plugins, search for "System - Redirect" and make sure it is enabled
URL format: Redirects are created for /component/k2/item/{id} and /component/k2/item/{alias} patterns. If your K2 used different URL routing, you may need to add custom redirects.
Export Downloads Empty File
Select at least one table: Ensure you have checked at least one table checkbox before clicking Download
K2 tables must have data: If a K2 table is empty, that section of the export will be empty
PHP output buffering: If the download file is corrupted, another extension or plugin may be outputting content before the download headers. Try disabling debug mode temporarily.
White Screen or PHP Errors
Enable Joomla's Error Reporting in System > Global Configuration > Server — set to "Maximum" temporarily
Check your PHP error log (usually in /logs/ or configured in php.ini)
Common causes: insufficient memory, missing PHP extensions, or database connection issues