If the SEO calendar doesn't publish your approved posts to WordPress, it's almost always the connection: a wrong password, missing permissions or an unreachable address. Here you'll see where to find the reason and how to fix it. How to set up the connection is covered in Setting up the SEO calendar and connecting WordPress.
Where you see errors
FlowSEO checks a connection when you create it. In the Add connection window, click Save and check, and FlowSEO reports one of two results:
- “Connection checked, all fine.”
- “Connection saved, the check failed:” followed by the reason.
If a scheduled publication fails later, you'll see it in the calendar: in the post's review panel it says “Publishing failed:” followed by the reason, in the same wording as when checking a connection. For timeouts and server errors, FlowSEO itself tries delivery up to three times first.
The messages during the check
“Login refused. Check username and application password.” WordPress didn't accept the credentials. Most common cause: the normal login password was entered instead of an application password. In WordPress, go to Users, Profile, Application Passwords, create a new password and use exactly the username it belongs to. Some security plugins turn off application passwords.
“The WordPress user may not publish posts or upload media.” The user has too few permissions, for example the role “Contributor”. In WordPress, give the user at least the role “Author”, or “Editor” if pages are to be created.
“The interface was not found. Is the site's REST API reachable?”
FlowSEO publishes via the WordPress REST API. As a test, open https://your-site.com/wp-json/ in your browser. If you see an error message or a login page, the API has to be opened up.
“The address redirects. Please enter the final address.”
The address redirects, for example from https://example.com to https://www.example.com. Enter the address where the page actually lands.
“The address is not publicly reachable or not https.” The site must be reachable over https from the internet. Sites on a local network or behind password protection don't work.
“The other side was unreachable or overloaded.” or “The connection timed out.” The website didn't respond in time. This is often temporary. Try again later.
“The other side refused the request.” WordPress responded with a different error status, often because a security plugin or firewall is blocking the request.
When creating: errors in the form
- “The WordPress site must be on example.com or one of its subdomains.” FlowSEO publishes only on the domain the calendar runs for, for example on
blog.example.com. - “This address is not publicly reachable.” The address can't be resolved from the internet. Check the spelling.
Reschedule the publication
- Fix the cause, for example with a new application password.
- In the calendar, use Manage automations and Connect WordPress or a webhook to create a new connection with the right details. It is then available for selection under Publishing. Click Save.
- Open the affected post, choose a time under Publish on or leave the field empty for immediately, and click Approve and schedule.
Our team can edit or delete an existing connection. Also contact us if an old connection should be removed.
If the post itself is the problem
Checking a connection doesn't reveal three causes, because they only occur when a post is sent: a page or post already exists at that address on the website, an image is larger than the 25 MB that FlowSEO passes on to WordPress, or an image is missing from the media library.
In these three cases the post goes back to review by itself and the approval is lifted so that you can change it. The review panel tells you the reason. Because the date has passed, the calendar shows the post as Overdue. You change the URL slug with the pencil and the main image with Change image, and then click Approve and schedule. Without this new approval, the post doesn't go out. A connected AI agent takes the same route: it changes the slug and approves the post again, with the switch turned off only with your consent. If an image in the text is too large or missing and isn't the main image, our team can help, because images in the text can't be swapped in the calendar.
Good to know
- Our team sets the categories for WordPress posts once a connection has been checked successfully.
- Without a connection, your team gets the posts by email with all exports. You can switch back to By email to the team under Publishing at any time.