Skip to main content

Webflow Troubleshooting

Use this page when Webflow connection or publishing fails.

1) Connection errors​

Unauthenticated or invalid token​

Usually means the API token is invalid, expired, or pasted incorrectly.

Fix:

  1. Regenerate a fresh token in Webflow.
  2. Confirm required scopes are enabled.
  3. Reconnect in Settings -> Integrations -> Webflow.

Unauthorized or permission denied​

Usually means token scopes are insufficient for the action.

Fix:

  1. Ensure the token has:
    • CMS: read and write
    • Sites: read
    • Assets: read and write
  2. Reconnect and retry a single test publish.

2) Validation and schema errors​

ValidationError or field mismatch​

This happens when your Webflow collection fields do not match current integration mapping.

Fix:

  1. Open Webflow integration in Jottler.
  2. Refresh site/collection mapping.
  3. Re-map required fields (title, slug, body).
  4. Save and republish one item.

Slug conflicts​

If a slug already exists in the collection, publish may fail.

Fix:

  • Update the slug for the item in Jottler or Webflow.
  • Republish the item.

3) Sync appears successful but item is missing​

Check:

  • Correct Webflow site and collection are selected.
  • CMS item status in Webflow (draft/staged/live depending on your workflow).
  • Filters in Webflow CMS UI are not hiding the item.

4) Content publishes but displays incorrectly​

This is usually a template/CSS issue in Webflow, not a publishing issue.

Next step:

5) Quick recovery flow​

  1. Reconnect with a fresh token.
  2. Confirm permission scopes.
  3. Refresh field mapping.
  4. Force a single-item resync/publish test.
  5. Verify item in Webflow CMS and front-end template.