Skip to main content

WordPress Troubleshooting

Use this page when connection or syncing fails after integration.

1) Cannot connect WordPress​

Common error signatures​

  • 401 Unauthorized
  • rest_cannot_create
  • invalid_username
  • incorrect_password
  • Timeout or blocked request errors

Connection checklist​

  1. Confirm Site URL is correct and reachable over HTTPS.
  2. Confirm username/email matches the WordPress account exactly.
  3. Recreate and paste a fresh Application Password.
  4. Confirm the user role is Editor or Administrator.
  5. Confirm REST API loads at https://yourdomain.com/wp-json.

Why Application Passwords fail​

Application Password auth can fail when:

  • The site is local/private and not publicly reachable.
  • HTTPS is not configured.
  • Security plugins block REST auth requests.
  • Host-level WAF/firewall blocks API calls.

2) WordPress sync issues​

If connection succeeds but posts do not arrive correctly, check:

  • Publishing mode (draft vs auto-publish settings in Jottler)
  • WordPress role capabilities for the connected user
  • Plugin conflicts that alter post content or REST behavior
  • Caching layers that delay visible updates

3) Security/plugin conflicts​

The most common blockers are security tools or login hardening plugins.

Review:

  • Wordfence (REST/login restrictions, 2FA gating, brute-force rules)
  • Cloudflare/WAF rules blocking API requests
  • Plugins that disable or lock down /wp-json
  • Plugins that sanitize embeds/HTML aggressively

If needed, temporarily disable suspect plugins and test a single publish.

4) REST endpoint verification​

These should return valid responses:

  • https://yourdomain.com/wp-json
  • https://yourdomain.com/wp-json/wp/v2/posts

If these are blocked or return auth errors unexpectedly, resolve REST access first.

5) IP allowlist requirement​

Some hosts require allowlisting outbound integration IPs.

  • If your host firewall blocks Jottler requests, contact Jottler support and request the current egress IP list for allowlisting.
  • Re-test connection after firewall updates propagate.

6) Quick recovery sequence​

  1. Regenerate Application Password.
  2. Reconnect WordPress in Jottler.
  3. Publish one test item as draft.
  4. Verify in WordPress admin and REST API.
  5. Re-enable production workflow.