> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://mavic.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Publishing Failed

# A scheduled post failed to publish — what to do

If a post in your Calendar shows **Failed**, here's how to fix it.

## Quick checks

1. **Open the failed post** on the Calendar
2. **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](https://mavic.crisp.help/en/article/editing-captions-per-platform-1jihvy9/).

### Tag/mention couldn't be resolved

* **Symptom:** an `@mention` in 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](https://mavic.crisp.help/en/article/tagging-companies-and-users-ss4wvp/).

### 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 Calendar, 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](https://mavic.crisp.help/en/article/slack-connection-1saihpj/).
* 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

* [Multi-channel publishing](https://mavic.crisp.help/en/article/multi-channel-publishing-1w83o5k/)
* [Can't connect a social channel?](https://mavic.crisp.help/en/article/cant-connect-social-channel-1lzloi8/)
* [Connecting Slack for notifications](https://mavic.crisp.help/en/article/slack-connection-1saihpj/)



**Updated:** May 2026