Read why it failed
In Day and Week view, a failed post has a red ring and a red !. In Month view it has a red outline only, so switch to Week to read the reason. Hover the ! to see it: the message PostQueen kept for the post, up to 300 characters. When there is no readable message, it says “An error occurred while publishing this post”. Open the post and the composer says it too, in a red banner above the editor: “This post didn’t go out on” and the date it was due, then “Reason:” and the message, then “Fix it, then schedule it again or post it now.” In the Posts list, failed posts are only under All, marked Error. Scheduled shows posts still ahead of you, so a failed post never appears there. Most reasons are the network’s own words. These come from PostQueen:
Anything else came from the network. Its page lists the rules PostQueen checks before a post is scheduled: start from All channels, fix the post, then send it again. An unchanged post that the network refused is refused again.
How PostQueen retries
PostQueen makes up to 5 attempts at one post. It tries again when the channel’s sign-in had expired and was renewed, or when an attempt could not start. It stops at once when:- the network refused the content, for example its length or its media;
- the channel’s sign-in could not be renewed, so the channel needs reconnecting;
- the post was sent but no answer came back, so it may be live: Sent, but not confirmed.
A post is marked failed after its first failed attempt, not its last. If a later attempt works, the same post turns into a published one. Give a fresh failure a few minutes before you send it again.
Sent, but not confirmed
Sometimes the post reached the network, but PostQueen could not confirm that it went live: the network did not answer in time, or never gave a final answer. The post is marked failed, and you get this notice:Your post was sent to network, but we couldn’t confirm it was published. Please check your channel account before posting again to avoid duplicates.
Not failed yet
- Publishing. A scheduled post whose time has passed shows Publishing until the network confirms it. Some networks accept a post and publish it later. PostQueen then checks every 20 seconds for about 30 minutes, and says so in your notifications: “Network accepted your post and is still processing it. It will be confirmed here once it is live.”
- Missed while PostQueen was busy. Once an hour, PostQueen looks for scheduled posts from the last two days that never ran, on channels that are connected and turned on, and publishes them. It never picks up a failed post.
- Draft. A draft keeps its date on the calendar but never publishes until you schedule it.
The channel needs reconnecting
When a network stops accepting the channel’s sign-in and PostQueen cannot renew it, you get “Could not refresh your network channel (account). Reconnect it to keep publishing.” The channel shows Needs reconnecting on Channels, and every post due on it fails with “Refresh channel needed” until you reconnect it.1
Open the channel
Follow the link in the notice, or open Channels and choose the channel marked Needs reconnecting.
2
Reconnect it
Choose Reconnect and sign in to the network again. A network that uses a key or a password asks for it again.
3
Send each failed post again
The posts that failed while the channel was disconnected do not resume by themselves. Send each one again.
Send the post again
- Drag it on the calendar
- Edit and update it
- The API, the CLI or an agent
Drag the failed post onto a slot in the future. PostQueen does not ask you to confirm: it shows “Scheduled for” with the new time and publishes the post then.
Notifications about failed posts
A failed post writes a notification in the app, and most of these are also emailed.
Turn Failure Emails on or off in Settings under Notifications. A later failed attempt at the same post does not notify you again.
Still stuck?
Email support@postqueen.ai with:- the channel, and the time the post was due, with your time zone;
- the reason in the tooltip, word for word, and the notification you got;
- the post’s ID, if you use the API or the CLI.
Next steps
All channels
Each network’s rules and messages.
Common errors
Messages from signing in to paying.
The calendar
Views, the Posts list and moving posts.
Support
How to reach a person.