Facebook Troubleshooting Guide

Comprehensive troubleshooting guide for Facebook issues in Publlish. Fix Facebook Page connection problems, failed posts, permission errors, link preview issues, and more.

If your Facebook integration isn't working the way it should, this guide walks through the most common issues and how to fix them. For specific error codes, see the Facebook error library →

Issue 1 — Facebook Page Not Appearing in Publlish

Symptom: When you try to connect a Facebook Page, the Page doesn't appear in the list.

Causes and fixes:

Wrong Facebook account You may be logged into Facebook with the wrong account — one that doesn't have admin access to the Page. Log out of Facebook in your browser, then log back in with the account that is listed as Admin on the Page, and restart the connection flow.

Insufficient admin role Your account may have Editor, Analyst, or Advertiser access but not Admin. Only Admin-level access allows you to connect a Page to Publlish. Ask the Page owner to update your role to Admin in Facebook Page Settings → Page Roles.

Page managed through Business Manager If the Page is managed through Facebook Business Manager (Meta Business Suite), make sure the Facebook account you're connecting with has been added as an Admin in Business Manager — not just on the Page itself.

Issue 2 — Facebook Posts Failing to Publish

Symptom: Posts scheduled to Facebook are failing and showing errors in your queue.

Step 1 — Check the error code Click on the failed post in your Publlish queue to see the specific error message. This tells you the exact cause. Full error code reference →

Step 2 — Refresh the connection The most common cause of post failures is an expired token. Go to Channels and click Refresh next to your Facebook Page. How to refresh →

Step 3 — Reconnect if refreshing fails If Refresh doesn't resolve the issue, disconnect the Page and reconnect it through the full connection flow, making sure to accept all permissions.

Step 4 — Check the post content Some failures are caused by the content itself — an invalid URL, a video format Facebook doesn't accept, or a caption that's been flagged. Try publishing a simple text post to test whether the channel is working, then diagnose the content issue separately.

Issue 3 — Facebook Connection Keeps Breaking

Symptom: Your Facebook Page connects fine, but keeps disconnecting after a few days or weeks.

Causes:

Password change — every time you change your Facebook password, all connected app tokens are invalidated. Refresh Publlish immediately after any password change.
Permission revocation — if someone with admin access on the Page removes Publlish from the Page's connected apps, the connection breaks.
Facebook security sweep — Facebook occasionally revokes app tokens as part of security reviews.

Fix: Go to Channels and Refresh after any account security changes. Enable Publlish email notifications so you're alerted when a reconnection is needed.

Best practices for keeping channels connected →

Issue 4 — Link Previews Showing Incorrectly

Symptom: When sharing a link, the preview image, title, or description is wrong, outdated, or missing.

Cause: Facebook caches link preview data and doesn't always update it automatically when a page is edited.

Fix:

Copy the URL you're trying to share
Go to the Facebook Sharing Debugger
Paste the URL and click Debug
Click Scrape Again to force Facebook to refresh the cached data
Once the debugger shows the correct preview, reschedule your post in Publlish

If the preview is consistently wrong across all posts (not just one URL), check that your Facebook Domain Verification is set up. Facebook Domain Verification guide →

Issue 5 — "Unavailable" Facebook Channel

Symptom: Your Facebook Page shows as "Unavailable" in Publlish.

Cause: The Page is already connected to a different Publlish organisation. A Page can only be actively connected to one Publlish organisation at a time.

Fix: Identify which other Publlish organisation the Page is connected to, disconnect it from there, then connect it here. If you're unsure which organisation it's in, contact Publlish support.

Unavailable channels guide →

Issue 6 — Facebook Analytics Not Showing in Publlish

Symptom: Your Facebook Page is connected and posts are publishing, but analytics data isn't appearing.

Causes and fixes:

New connection — analytics data takes 24–48 hours to start populating after a new connection
Insufficient permissions — make sure the Admin account used to connect the Page granted Publlish access to Page Insights during the connection flow. Reconnect if you're unsure.
Page with very few followers — Facebook restricts Insights data for Pages with very small audiences. Some metrics only unlock once a Page reaches a minimum follower threshold.

Issue 7 — Posts Publishing to the Wrong Facebook Page

Symptom: A post intended for one Facebook Page published to a different connected Page.

Fix: Check the channel selector when composing posts — make sure the correct Page is selected before scheduling. If you manage multiple Pages with similar names, rename them clearly in Publlish using Channel labels to avoid confusion.

Quick Diagnostic Checklist

Before contacting support, run through this checklist:

[ ] Is the Facebook channel showing a green connected status in Channels?
[ ] Has the connection been refreshed recently?
[ ] Does the connected Facebook account have Admin role on the Page?
[ ] Were all permissions granted when connecting?
[ ] Has your Facebook password been changed since connecting?
[ ] Is the post content valid (non-empty, valid URLs, supported media format)?
[ ] Is the Page in good standing on Facebook (not restricted or unpublished)?

If all boxes are checked and the issue persists, contact Publlish support with the specific error message and the time the post was scheduled.

Frequently Asked Questions

Why does Facebook keep disconnecting from Publlish? Token expiry is normal — it's a Facebook security requirement. The most common triggers are password changes and permission revocations. Keeping channels connected →

My Facebook post failed with no error message — what do I do? Contact Publlish support with the post details. Some failures don't return an error code from Facebook's API, but the support team can investigate the logs.

Can I prevent Facebook from expiring my Publlish connection? You can't prevent token expiry entirely, but posting regularly and not changing your password frequently will help maintain stable connections.

My Facebook Page is connected but I can't see analytics — why? Check that you granted Publlish access to Page Insights when connecting. If not, reconnect the Page and accept all permissions. New connections also take 24–48 hours to start showing data.