Troubleshooting

What each publishing error means, and the change that clears it.

Citeca shows you the error your platform actually returned, not a paraphrase of it. Every message below is one we have seen in the wild, with the fix.

Start with Details for support

Under any failed publish there is a collapsible panel with the endpoint we called, the HTTP status, the method and the response body. That is almost always enough to identify the cause in one read — and it is the single most useful thing to include in a support message.

Authentication#

WordPress rejected the username or application password

An application password is not your login password. In WordPress go to Users → Profile → Application Passwords, create a new one, and paste it whole — spaces and all, we strip them. Also check the username is the WordPress username rather than the email address.

This Integration Key does not match the one on your site

Keys are per site and only the most recent one works. Open Citeca in your WordPress sidebar, generate a new key, and paste that into Manage on the WordPress card.

The Integration Key was not accepted because none arrived

The request reached WordPress without a key, which usually means a security plugin or proxy is stripping custom headers. Ask your host whether X-API-Key or Authorization headers survive to PHP.

Your site is temporarily refusing key checks

The plugin rate-limits after repeated failures to stop key guessing. It clears in fifteen minutes. Make sure you are pasting the current key before trying again.

Webflow returned 401 or 403

The token has been revoked, regenerated, or lacks permissions. It needs CMS: read and write plus Sites: read only. Generate a fresh one and paste it into Manage.

Nothing answered, or the wrong thing did#

The Citeca plugin did not answer at your site address

Three causes, in order of likelihood: the plugin is not activated; the site address is wrong (check https and whether the site lives under a subdirectory); or a security plugin has disabled the WordPress REST API. Loading /wp-json/ in a browser tells you which — it should return JSON, not a 404 or a firewall page.

No WordPress REST API answered at that address

Same root cause without the plugin involved. Confirm /wp-json/wp/v2/ responds. Disable REST-blocking options in security plugins such as Wordfence or iThemes, and check your host is not filtering it.

Your site answered, but not with the Citeca plugin

Something is serving that path that is not us — a caching layer, a holding page, or a different site on that domain. Check the address points at the WordPress install you meant.

A 5xx status, or a response that is clearly an HTML error page

Your server errored rather than refusing us. Check your PHP error log around that timestamp; a plugin conflict or a memory limit during image import is the usual explanation.

The article published, but looks wrong#

The article has no styling — plain text, no spacing

We send semantic HTML and your theme styles it. If your theme has no styles for post content, or the CMS template renders a plain field, that is what you see. Compare against a post you wrote by hand: if that looks the same, it is the template.

Markdown symbols are visible on the page

Content is converted to HTML before sending, so this indicates an older publish. Open the article and press Republish — it is corrected in place, on the same URL.

Webflow’s Editor shows broken layout or visible markup

A known Webflow issue with CMS rich-text fields in their Editor, not a problem with the article. Check the published page on your live domain, where it renders correctly.

Images are missing or broken

With the Citeca plugin, images are uploaded into your media library — a failure here is usually a file-permissions or upload-limit problem on the host. Check Media in WP admin to see whether they arrived.

Embeds or inline styles were stripped

WordPress removes unfiltered HTML unless the publishing author has the unfiltered_html capability. Publish as an author who does, or accept the sanitised version.

Duplicates and URLs#

I have two copies of the same article

Articles are matched on slug, so this happens when the slug changed between publishes — usually because the title was edited after the first publish. Delete the copy you do not want and keep the URL that has been indexed longest.

Webflow created a second item with a suffix

Webflow appends a suffix when a slug collides. We now look the item up first and patch it, so republishing updates in place. If you have historic duplicates, remove the extras by hand once.

The published URL is truncated

Long titles produce long slugs, and platforms cap them. It is cosmetic and does not affect indexing, but if you want a shorter URL, shorten the title before the first publish.

Unpublishing#

One site would not let go of the article

The others were still taken down, and Unpublish stays available so you can retry just the one that failed. Fix the underlying cause first — usually an expired token or a collection that no longer exists.

Citeca cannot take content down from this platform automatically

Programmatic unpublishing is supported for WordPress, Webflow and Joomla. For other platforms, unpublish the post in that platform directly — the message names which one.

An unpublished article came back on its own

It should not, and it will not: unpublishing marks the article as deliberately taken down and the scheduler skips it. If you pressed Publish afterwards, that is what opted it back in.

Nothing is recorded as published, so there is nothing to take down

The article has no record of reaching a connected site — usually it was published before you connected the destination, or it was removed by hand. Remove it in your CMS directly.

Nothing is publishing at all#

  1. 1Check a destination is connected — Settings → Publishing should show a Connected badge.
  2. 2Check auto-publish is on, if you are waiting for it to happen by itself.
  3. 3Check the connection is not set to draft only, which delivers articles without making them public.
  4. 4Check the article is actually finished. Planned and generating articles have nothing to publish yet.
  5. 5Press Publish on one article by hand. It runs immediately and reports the real error, which is faster than inferring one from silence.

Tip

Still stuck? The assistant in the bottom-right of the dashboard can see your connections and recent publish attempts, which saves you describing them.

Something missing or wrong here? Tell us and we will fix it.

Still stuck?

Can’t find the answer? Ask a person.

Tell us what you were trying to do and where it stopped. If the answer belongs in these docs, we add it here too.

Already a customer? Open your dashboard