Publishing Failed
A scheduled post failed to publish — what to do
If a post in your Planner shows Failed, here's how to fix it.
Quick checks
- Open the failed post on the Planner.
- Read the error message — it's shown at the top of the post.
The error usually points directly at the cause. Common ones below.
Common causes & fixes
Token expired
- Symptom: error mentions "authentication" or "permissions"
- Fix: Integrations → find the channel → Reconnect. Then Retry the post from the Planner.
Image format not supported
- Symptom: error mentions image dimensions, file size, or format
- Fix: Re-generate the image with the right aspect ratio, or upload a new one. Each platform has its own specs:
- Instagram feed: 1:1 or 4:5, JPEG/PNG, max 30MB
- Stories/Reels: 9:16, MP4 for video
- LinkedIn: PDF for carousels; JPEG/PNG for single images
- X: JPEG/PNG/GIF, max 5MB
Video too long or wrong format
- Symptom: Reel/TikTok/Stories video failed
- Fix: Check the video meets the platform's spec (MP4, vertical 9:16, length under platform limit). Re-export and re-attach.
Caption too long for the platform
- Symptom: error mentions character count
- Fix: Switch to that platform's tab in the post editor and trim the caption. See Editing captions per platform.
Tag/mention couldn't be resolved
- Symptom: an
@mentionin the caption is invalid - Fix: Verify the username/URL is correct. For LinkedIn, only company/organization URLs are accepted. See Tagging companies & people in posts.
Rate limited by the platform
- Symptom: error mentions "rate limit" or "too many requests"
- Fix: Wait 10–15 minutes and retry. If it keeps failing, space your scheduled posts further apart.
Platform-side outage
- Symptom: error mentions "internal" or "service unavailable"
- Fix: Check the platform's status page (e.g. Meta Status, X Status). If the platform is down, retry later.
Retrying a failed post
From the Planner, open the failed post and click Retry. If you fixed the underlying issue, the post will publish.
Setting up failure notifications
If you want to know about failures faster:
- Connect Slack — failures push instantly to your channel. See Connecting Slack for notifications.
- Failures also appear on the dashboard.
What if the post partially succeeded?
If you scheduled a multi-channel post and only some channels failed:
- The successful channels are live — nothing to do
- The failed channels show as Failed individually — fix and retry each separately
Related articles
Updated: May 2026
Updated on: 07/05/2026
Thank you!
