Overview
Almost every WordPress publishing issue traces back to authentication, the REST API, HTTPS, or image handling. Match your symptom to the fixes below; most are a two-minute change in WordPress or ContentScaler. If a publish appears stuck, give it a few minutes and check WordPress directly before retrying.
Details
- Authentication error — verify the username, generate a new Application Password, and paste it complete (including spaces) into ContentScaler, then Test Connection again.
- REST API not available — a security plugin (Wordfence, iThemes) may block it; allow the REST API in the plugin, and confirm by visiting https://your-site.com/wp-json/ (should return JSON, not 404).
- HTTPS required — enable an SSL certificate, update the WordPress URL to https://, or use a plugin like Really Simple SSL; HTTP is only allowed for localhost development.
- Insufficient credits — check your balance and top up in Settings -> Credits (5 per publish + 1 per image).
- Image upload failed — keep images under WordPress's limit (10MB default), ensure they are publicly reachable over HTTPS, and retry the update.
- Stuck at Syncing — wait 2-3 minutes for large pages, refresh, and check WordPress to see whether the post was actually created before retrying.
- Formatting or SEO looks wrong — check theme/block-editor compatibility and field mappings; Yoast syncs automatically, Rank Math uses native fields.
Check before you move on
- Have your WordPress URL, version, the ContentScaler domain, the full error text, and the content page ID ready before contacting support.
- Back up WordPress before large batch operations.