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

# Troubleshooting Facebook publishing issues

> Fix issues with posts not publishing to Facebook from the HoopAI social planner, including token expiration, permissions, and content errors.

When posts fail to publish to Facebook from the HoopAI platform's social planner, the problem is usually related to expired tokens, missing page permissions, or content that violates Facebook's policies. This guide walks you through diagnosing and resolving each scenario.

***

## Common Facebook publishing issues

| Issue                                 | Likely cause                                                  |
| ------------------------------------- | ------------------------------------------------------------- |
| Post fails with "token expired" error | Facebook access token needs to be refreshed                   |
| Post fails with "permissions" error   | Page permissions were not granted during connection           |
| Post is rejected by Facebook          | Content violates Facebook's advertising or community policies |
| Image or video not uploading          | File format or size exceeds Facebook's requirements           |
| Scheduled post did not publish        | Scheduling conflict or timezone mismatch                      |
| Facebook page not showing in Hoop     | Account was not connected or page was not selected            |

***

## Step 1: Reconnect your Facebook account

Facebook access tokens expire periodically. When they do, all publishing will fail until you reconnect.

<Steps>
  <Step title="Go to social integrations">
    Navigate to **Marketing > Social Planner > Settings** in the Hoop platform and find the Facebook integration.
  </Step>

  <Step title="Disconnect the existing connection">
    Click **Disconnect** on your Facebook account. This removes the expired token.
  </Step>

  <Step title="Reconnect your account">
    Click **Connect Facebook Account** and log in with the Facebook account that has admin access to the page you want to publish to.
  </Step>

  <Step title="Grant all requested permissions">
    During the connection flow, Facebook asks you to approve permissions. Grant all requested permissions — especially **pages\_manage\_posts**, **pages\_read\_engagement**, and **pages\_manage\_metadata**. Denying any of these can prevent publishing.
  </Step>

  <Step title="Select your pages">
    After authentication, select the specific Facebook pages you want Hoop to manage. Only selected pages will appear in the social planner.
  </Step>
</Steps>

<Warning>
  If your Facebook account uses two-factor authentication, you will need to complete the verification step during reconnection. Have your authentication device ready.
</Warning>

***

## Step 2: Check page permissions

<Steps>
  <Step title="Verify your Facebook role">
    You must have an **Admin** or **Editor** role on the Facebook page. Go to your Facebook page, click **Settings > Page Roles**, and confirm your role.
  </Step>

  <Step title="Review connected apps in Facebook">
    In Facebook, go to **Settings > Security and Login > Business Integrations** and find the Hoop integration. Confirm all permissions are still granted. Facebook can revoke permissions if it detects inactivity.
  </Step>
</Steps>

<Note>
  If your Facebook page is managed by a Business Manager, the Business Manager admin may need to approve the Hoop integration before publishing works.
</Note>

***

## Step 3: Resolve content policy violations

Facebook rejects posts that violate its content policies. Common triggers include:

* Links to domains that Facebook has flagged as spam
* Text that resembles misleading health or financial claims
* Images with excessive text overlay (previously the 20% rule)
* Content that Facebook's automated system flags as potentially harmful

<Steps>
  <Step title="Edit the flagged content">
    Edit the post to remove or rephrase the flagged content. If a link was flagged, try shortening it or using a different landing page.
  </Step>

  <Step title="Resubmit the post">
    After making changes, reschedule or manually publish the post from the social planner.
  </Step>
</Steps>

***

## Step 4: Fix image and video issues

Facebook has specific requirements for media uploads:

| Media type | Requirements                                               |
| ---------- | ---------------------------------------------------------- |
| Images     | JPEG or PNG, max 10 MB, minimum 600x315 pixels recommended |
| Videos     | MP4 or MOV, max 10 GB, max 240 minutes, minimum 1 second   |
| Stories    | 1080x1920 pixels recommended, max 20 seconds for video     |

<Tip>
  If your image is too large, compress it before uploading. Most quality loss is not noticeable below 2 MB for standard social posts.
</Tip>

***

## Step 5: Fix scheduling issues

<Steps>
  <Step title="Check your timezone">
    Confirm your timezone is set correctly in **Settings > Business Profile** in the Hoop platform. A timezone mismatch can cause posts to publish at unexpected times or appear to not publish at all.
  </Step>

  <Step title="Review the scheduled time">
    Open the scheduled post in the social planner and verify the date and time. Ensure the scheduled time has not already passed.
  </Step>

  <Step title="Check for scheduling conflicts">
    Facebook limits how frequently you can post. If multiple posts are scheduled too close together, some may be delayed or fail.
  </Step>
</Steps>

***

## FAQs

<AccordionGroup>
  <Accordion title="How often do Facebook tokens expire?">
    Facebook tokens typically expire every 60 to 90 days. Hoop attempts to refresh tokens automatically, but some account configurations require manual reconnection. Reconnect promptly when you see a token expiration warning in the social planner.
  </Accordion>

  <Accordion title="Can I publish to Facebook groups from Hoop?">
    Hoop currently supports publishing to Facebook pages only. Group publishing is not available due to limitations in Facebook's API.
  </Accordion>

  <Accordion title="My post published but shows no engagement — is something wrong?">
    Low engagement is not a technical issue. However, if the post is not visible on your page at all, check whether Facebook flagged it for manual review. Review your page's **Support Inbox** in Facebook for any pending reviews.
  </Accordion>
</AccordionGroup>