Troubleshooting

Connection fails with an authentication error

• You used your email address. Application Passwords need your WordPress username.
• The password was retyped rather than pasted. Copy it exactly, spaces included.
• The Application Password was revoked in WordPress. Create a new one.
• The account lacks permission to publish posts on that site.

Connection fails before reaching WordPress

• The site must be reachable over HTTPS from the public internet.
• The REST API must not be blocked. Some security plugins and hosts disable it.
• Local, private-network and non-public addresses are refused by design.

"Plugin not detected"

Detection is read from the last successful site probe. If you installed the plugin after connecting, the stored value is stale. Open the site in the dashboard and use Refresh site info, or ask the agent to call site_health. A site that has been disconnected has no stored credential, so it cannot be probed until you reconnect it.

The post published but the featured image is missing

Check image_status on the action. If it is "failed", image_error says why — usually the URL was unreachable, returned HTML instead of an image, or was too large. If it is "none", no featured_image_url was sent. If it is "ok", the image did attach and your theme is not displaying featured images on single posts.

"Published (partial)"

The post is live, but a component failed. Read taxonomy_status, image_status, inline_images and seo_status on the action to see which one. Partial means the content landed — you can fix the component and update the post rather than republishing.

Failed vs Rejected

Failed means the system could not complete the publish; the action carries an error detail. Rejected means a person declined it in the approval queue. They are different states and the Activity feed keeps them apart.

SEO fields did not apply

seo_status "unsupported" means the companion plugin or an SEO plugin is missing. Yoast is verified end to end on a live site; Rank Math is supported but has not been tested. See the SEO fields article.

Duplicate posts

The agent retried without an idempotency_key. Pass a stable idempotency_key on every publish call.