Skip to content

Publishing failed

The usual reasons a publish to WordPress, Shopify or a webhook fails, and the fix for each.

The Publish menu shows the reason a publish failed. Fix it, then press Publish again. A retry updates the same post: it never creates a duplicate.

"Nowhere to publish to yet"

The site has no CMS connected. Open Settings, then Sites, then CMS.

"Publishing waits until your changes are saved"

Wait for the status to say Saved. A document is only published as saved, never with changes still on screen.

WordPress

  • The application password was revoked or changed. Disconnect, create a new application password, and connect again.
  • The WordPress user cannot publish. The user needs a role that can publish posts, such as Author or Editor.
  • A security plugin blocks the REST API. Application passwords work through the REST API. Allow it for that user.

Shopify

  • The app was uninstalled, or lacks the write_content scope. Reinstall it with that scope, then connect again.

Webhook

  • Your endpoint did not answer with a 2xx. The failure shows what it answered.
  • It redirected. Redirects are not followed; use the final address.
  • The signature did not verify on your side. Check you are verifying the raw body, before parsing it, with the secret shown when you connected.

See Publishing to your own site with a webhook.