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

# Troubleshooting

> Common Postiz problems and how to resolve them

The problems people hit most often, with concrete fixes. If yours isn't here,
see [Support](/general/support) for how to reach us: cloud customers by email or
Discord, self-hosters through the community Discord.

<CardGroup cols={2}>
  <Card title="Connecting a channel" icon="link" href="/general/troubleshooting/oauth-connect">
    "Invalid state", "invalid\_grant" and "fetch failed" during the connect flow.
  </Card>

  <Card title="Uploads and media" icon="cloud-arrow-up" href="/general/troubleshooting/uploads">
    Payload too large, upload-from-url timeouts, video failures.
  </Card>

  <Card title="Activation and login" icon="key" href="/general/troubleshooting/activation-and-login">
    Expired activation links, "jwt malformed", login API responses.
  </Card>

  <Card title="Known issues" icon="circle-exclamation" href="/general/troubleshooting/known-issues">
    Bugs we're aware of, with workarounds.
  </Card>
</CardGroup>

## A post failed to publish

Failed posts get a red ring on the calendar with the reason in a tooltip. The
three usual causes, in order of frequency:

1. **The channel needs reconnecting.** Access tokens expire. A channel showing
   a red marker in the sidebar needs re-authorising, see
   [Manage a channel](/general/channels/manage).
2. **The post broke a platform rule.** Too many images, a video where the
   platform wanted a photo, a missing required setting. See
   [Posting rules by platform](/general/platforms/overview).
3. **The platform rejected the content.** Duplicate text, a blocked link, or an
   account restriction. The tooltip carries the platform's own message.

## Elsewhere

<CardGroup cols={2}>
  <Card title="Plans, limits and billing" icon="credit-card" href="/cloud/overview">
    Channel caps, "you have reached the maximum", payment problems.
  </Card>

  <Card title="Self-hosting problems" icon="server" href="/self-host/troubleshooting">
    Install failures, database errors, ports, CORS, connect failures.
  </Card>
</CardGroup>