Skip to main content
Publishing failures almost always come down to one of four things: a connection that needs reconnecting, content a network won’t take, a destination that was never picked, or a Rheos safety check. Here’s how to spot and fix each.

​
A post failed to publish

Networks publish independently, so a failure is usually partial: one network is red and the rest went out. The post lands as partial (or failed, if none of them made it).
1

Open the post

Look under Drafts & recent on your Home dashboard, or Recent in the sidebar. Both list failed and partial posts.Don’t go looking in Content Plan — that timeline only carries posts still waiting to go out, so a failed post drops off it.
2

Read the error

The Results panel lists every network the post went to, with a red mark and the platform’s own error message on the ones that failed.
3

Fix and retry

Reconnect the account, or fix whatever the message asks for, then select Retry failed. That resends only the networks that failed — the ones that already published are left alone.
If the failure needs something the post doesn’t have — an image for Instagram, say — retrying can’t help. Use Create a new post to fix this. It clones the copy into a fresh draft targeting only the failed networks, and leaves the ones that already published alone.

​
Common errors

The network invalidated your access. Go to Settings → Social Accounts, open the brand section holding that account, and reconnect from its card. Then retry the post.Rheos renews most connections for you: Instagram in the background, X and Pinterest each time they publish, and LinkedIn too when your connection was issued a refresh token. Facebook is the one that always needs a manual reconnect, roughly every 60 days.Bluesky and Mastodon have no expiry date for Rheos to track, but Bluesky can still ask for a reconnect: Rheos refreshes the Bluesky session on every publish, and if Bluesky rejects that refresh the publish fails with a “Bluesky session refresh failed” or “Bluesky token refresh failed” error. That usually means the app password was revoked or changed — create a new one and reconnect the card.Reconnecting is also how you grant new permissions when Rheos adds a capability that needs them.
Instagram and Pinterest have no text-only post type, so Rheos blocks scheduling or publishing to them until the post has media attached. You’ll see “Instagram needs an image or video” (or “Pinterest needs…”) with “Add media or deselect that channel before publishing”.Add an image, carousel or video from the Attachments card — or untick that network for this post — and you’ll be able to publish.
A pin has to go somewhere. Until a default board is set, every Pinterest publish fails pre-flight with “No Pinterest board selected”.Go to Settings → Social Accounts, open the Pinterest card and select Pick board. The connect flow offers this once, but it’s dismissible — so it’s easy to miss.
If you admin more than one LinkedIn company page, Rheos authorises them all but publishes to only one — and it won’t guess which. Until you pick, company-page posts for that brand fail.Open Settings → Social Accounts, find the Company Pages card under that brand, and select Set active on the page you want to publish to.
Your Instagram account needs to be Business or Creator — personal accounts can’t publish through the API. Switch it in the Instagram app under Settings → Account type, then reconnect in Rheos.
Each network has its own rules. Instagram takes 1:1, 4:5 or 9:16 video, and a 9:16 clip posts as a Reel. Instagram carousels are capped at 10 slides and every slide has to match the first slide’s ratio; X caps a post at 4 images, Pinterest at 5.Rheos doesn’t check video length, so a clip over the network’s own limit is rejected by the platform rather than caught in the editor. Swap or re-encode the media and retry.
This is a Rheos cap, not the platform’s. To stay comfortably inside each network’s own limits, Rheos allows a set number of posts per connected account per day: X 15, Facebook 20, Pinterest 50, LinkedIn 80, Instagram 90, Bluesky and Mastodon 100.The counter resets at midnight UTC, so waiting an hour won’t help. Reschedule the post for the next day.
Rheos blocks republishing identical content — same text, same media, same networks — within 10 minutes, so an accidental double-click doesn’t double-post. You’ll see “You just published this exact post”.If you meant it, select Publish anyway on the warning. There’s no need to reword the copy.
Deleting an asset from your Library after attaching it to a post doesn’t raise an error. At publish time Rheos simply skips the attachment it can no longer find, and the post goes out text-only on every network that allows text-only posts.On Instagram and Pinterest, which need media, losing the only attachment leaves nothing to send and that network fails with “Instagram requires at least one media item” or “Pinterest requires an image to create a pin”.Either way the fix is the same: open the post, attach the image again from the Attachments card, and publish it again. Deleting from the Library is what breaks the link — keep an asset there while any post still references it.

​
Still stuck?

Email support@rheos.app with the post title, the network that failed, and the error message shown in the Results panel. Those three things are what we need to trace it.
Last modified on August 4, 2026