> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rheos.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing troubleshooting

> Why Rheos posts fail to publish — expired social connections, platform rejections, media size limits and account permissions — and how to fix each problem.

Most publishing failures come down to one of three things: an expired token, a content rule a platform enforces, or a permissions gap. Here's how to spot and fix each.

## A post failed to publish

When a scheduled post fails, it stays in your queue with a red status and an error message. Open the post to see which platform failed and why — other platforms in the same post will still have gone out.

<Steps>
  <Step title="Open the failed post">
    Select it in the calendar or posts list. You'll see a status per network.
  </Step>

  <Step title="Read the error">
    Hover the failed network to see the platform's exact message.
  </Step>

  <Step title="Fix and retry">
    Either reconnect the account, edit the content, or remove the failing platform — then select **Retry publish**.
  </Step>
</Steps>

## Common errors

<Accordion title="Token expired / reconnect required">
  The platform invalidated your access. Go to **Settings → Social Accounts** and select **Reconnect** next to the affected network. Then retry the post.

  Rheos auto-refreshes tokens where the platform allows it, but some (TikTok, X) need a manual reconnect every few months.
</Accordion>

<Accordion title="Instagram: account not eligible">
  Your Instagram account needs to be **Business** or **Creator** (not personal) to publish via the API. Switch it in the Instagram app under Settings → Account type, then reconnect in Rheos.
</Accordion>

<Accordion title="LinkedIn: missing permissions">
  If Rheos has recently added new features (e.g. company mentions), you may need to reconnect to grant the extra scopes. Disconnect and reconnect from **Settings → Social Accounts**.
</Accordion>

<Accordion title="This platform needs an image or video">
  Some networks have no text-only post type, so Rheos blocks scheduling or publishing to
  them until the post has media attached. This applies to **Instagram**, **Pinterest**,
  **TikTok** and **YouTube Shorts**. Add an image, carousel or video in the
  **Attachments** panel — or untick that platform for the post — and you'll be able to
  publish.
</Accordion>

<Accordion title="Media format rejected">
  Each network has its own rules. TikTok and Instagram Reels need vertical (9:16) video. X caps video at 2 minutes 20 seconds. Instagram caps carousels at 10 slides. Swap or re-encode the media and retry.
</Accordion>

<Accordion title="Rate limited">
  You've hit a platform's posting cap (most enforce per-hour or per-day limits). Wait an hour and retry, or reschedule for later.
</Accordion>

<Accordion title="Duplicate content">
  X and LinkedIn block exact-duplicate posts within a short window. Tweak the copy slightly and retry.
</Accordion>

## Still stuck?

<Note>
  Email **[support@rheos.app](mailto:support@rheos.app)** with the post title, the platform that failed, and the error message. We can usually diagnose within a few hours.
</Note>