Troubleshooting

Start narrow

Most issues fall into connection, authentication, storage, compatibility, import data, or PHP runtime categories. WPChangeSync includes guidance for connection issues, import failures, storage issues, debug mode, duplicate media after import, and global style warnings.

Checklist

• Confirm WPChangeSync version compatibility on both sites.
• Confirm HTTPS and Application Password auth for remotes.
• Check storage path writability.
• Run a dry run before production imports.
• Inspect Activity and workflow run details.
• Check PHP logs for fatal errors or missing handlers.

Remote API errors

Remote import errors are intentionally sanitized for callers. If a remote push fails, check the target site Activity log and PHP error log for detailed diagnostics.

Reference checklist

Fast checks: verify version compatibility, HTTPS, Application Passwords, storage permissions, Activity entries, and PHP error logs.