If you receive an error message when trying to display your Facebook posts then you can use the table below to diagnose the issue and find the relevant solution.
For older versions of the plugin before v4.0, please see legacy documentation here.
PPCA Error: Due to Facebook API changes it is no longer possible to display a feed from a Facebook Page you are not an admin of. The Facebook feed below is not using a valid Access Token for this Facebook page and so has stopped updating.
The Access Token you are using is not from an admin of the Facebook page.  See here for directions.
Your Access Token is not approved to access the AP
Youâre unable to use this Access Token in the plugin. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
(#10) To use âPage Public Content Accessâ, your use of this endpoint must be reviewed and approved by Facebook.
The Access Token you are using is not from an admin of the Facebook page.  See here for directions.
Your Access Token is not approved to access the API
Youâre unable to use this Access Token in the plugin. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
(#10) This endpoint requires the âmanage_pagesâ or âpages_read_engagementâ permission or the âPage Public Content Accessâ feature.
The Access Token you are using is not from an admin of the Facebook page.  See here for directions.
Your Access Token is not approved to access the API
Youâre unable to use this Access Token in the plugin. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
(#100) Pages Public Content Access requires either app secret proof or an app token
The Access Token you are using is not from an admin of the Facebook page.  See here for directions.
Your Access Token is not approved to access the API
Youâre unable to use this Access Token in the plugin. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
Error: An unknown error occurred. Or, Error: An unexpected error has occurred.
You may be requesting too many posts
If you request too much data from Facebookâs API then it will occasionally send back an âunknown errorâ message. Facebook has certain limitations on its API and doesnât allow you to retrieve too much data in one request and put too much load on their servers.
Solution:
If youâre requesting a high number of posts or have the post limit set very high then try reducing the post limit. You can do this via the setting located under Facebook Feed > All Feeds > select Edit for the relevant feed > Settings > Advanced > API Post Limit
Facebookâs API may have a temporary issue
Facebookâs API may be unreachable temporarily. Try waiting a few minutes and then trying again. You can clear the plugin cache and force the plugin to check the Facebook API again by going to Facebook Feed > Settings > Feeds > click Clear All Caches. You can also do this for an individual feed by going to Facebook Feed > All Feeds > click Edit for the feed > Settings > click Clear Feed Cache.
Error: Error validating application. Application has been deleted. Type: OAuthException. Code: 190
You need to obtain an Access Token
Facebook may have made a platform change that caused an issue with our plugin connecting to their API. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
Error: (#4) Application request limit reached
You need to obtain an Access Token
Facebook may have made a platform change that caused an issue with our plugin connecting to their API. To fix this issue, first, update the plugin to Pro v4.0+ or Free v4.0+ and then either set up a new feed or edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
Error: Error validating access token: Session has expired on ____
Your Access Token has expired or wasnât extended correctly
The Access Token you are using has expired. To fix this issue, first ensure you have the latest version of the plugin. If not, update the plugin to the latest version (you can find the latest version numbers in the change logs here: Pro, Free). Then, update your Page Source in the Settings tab for the specific feed. If youâre having an issue updating the plugin then please see this FAQ.
If you are using a token from your own Facebook app, then make sure you extended the token by following the directions in steps 13 and 23 of the Page Access Token directions. Itâs important to copy the token from step 16 into the field in step 23 and click the âExtend my tokenâ button.
Error: (#32) Page request limit reached. Type: OAuthException. Code: 32
Your Access Token is making too many requests
This error occurs when the Access Token youâre using is making too many requests to Facebook in a short period of time. If you are using the same Access Token (which is the case if you connect everything to your personal Facebook account) to display a lot of different Facebook feeds â either on your own website or across multiple sites â then you may exceed the API request limit that Facebook has set for your Access Token. This is usually simple to fix by just changing the caching settings in the plugin under Facebook Feed > Settings > Feeds. For example, if you have the Caching setting set to be a short period of time (less than 15 minutes) then the plugin will be making more requests per hour than if it is set to be 1 hour, especially if youâre using this same setting for multiple feeds.
How many requests can I make with the same token?
This varies based on the Facebook page that the Access Token is from. Facebook grants an API request limit to an Access Token based on how many engaged users the Facebook page that the Access Token is from has. An âengaged userâ is any user who has clicked on your Facebook Page or its content within a 24 hour period. For every engaged user your Access Token is granted a request limit of 4,800 per rolling 24 hour period. For more information on Facebook API Request Rate Limits please see here.
How can I resolve this error?
The best thing to do initially is to drastically increase the plugin caching time so that it makes requests to Facebook less often. You can do this by increasing the time in the Caching setting to be 1 hour or greater. Once the Access Token is working successfully again (usually within a few hours) then you can set this to be lower, but there are a few factors to consider:
1) How active your Facebook page is. If it isnât very active then itâs likely you havenât had many engaged users in the past 24 hours and so your Rate Limit will be low. In order to increase your API Rate Limit, if only temporarily, you could post on your Facebook to encourage engagement from your users in the form of clicks, likes, shares, or comments.
2) How many feeds are using this Access Token. If you have 5 feeds using it then it will make a lot fewer requests than 20 feeds.
Error: No posts available for this Facebook ID
Your Facebook page may have restrictions on it
The feed youâre trying to display has to be a publicly accessible page. If your page has any restrictions on it (age or location) then it means that users are forced to sign into Facebook in order to view your page. This isnât desirable for most pages as it means that it isnât accessible by people who donât have a Facebook account and that your page canât be crawled and indexed by search engines.
An easy way to determine whether your page is set to public is to make sure youâre signed out of your Facebook account and then try to visit your page. If Facebook forces you to sign in to view your page then it has a restriction on it.
Solution:
You can remove any restrictions by logging into your Facebook account and going to the Settings for your page. You can then remove any Country Restrictions and Age restrictions (see screenshot). Once removed this will allow the Custom Facebook Feed plugin to access and display your posts.
Your Facebook page may not have any posts in it
If your page is fairly new then it may not actually have an eligible posts that the plugin can display. Notifications such as â__ changed the cover photoâ or â__ created a pageâ are filtered out and arenât displayed.
Solution:
Try creating a new post on your page and then viewing the pluginâs feed again.
Your Facebook page might not be published
When creating a new Facebook page it isnât actually published publicly until you click âPublishâ at the top of your page. If it isnât published then the plugin isnât able to retrieve your posts.
Solution:
Check the top of your page to see whether there is a âPublish my pageâ or similar button.
(#190) Permissions error. Error: Unsupported get request. Object with ID â____â does not exist, cannot be loaded due to missing permissions, or does not support this operation.
You do not have permission to access this data
The Access Token you are using doesnât have permission to access this data. This may be because youâre using an incorrect Page ID. Please see this page for directions on how to obtain your Facebook Page ID.
Error: (#190) Access to this data is temporarily disabled for non-active apps or apps that have not recently accessed this data due to changes we are making to the Facebook Platform. https://developers.facebook.com/status/issues/205942813488872/ Type: OAuthException. Code: 200
Youâre using a new or inactive Facebook developer app to generate an Access Token
Due to some sudden Facebook changes âAppâ Access Tokens from new Facebook apps are temporarily unable to access the Facebook API.  To fix this issue, simply update the plugin to the latest version (you can find the latest version numbers in the change logs here: Pro, Free) and click the blue Facebook button labeled âConnect a Facebook Accountâ on the pluginâs settings page. This will then provide you with your own Access Token. If youâre having an issue updating the plugin then please see this FAQ.
No error, just blank space
You may be using a Facebook ID from a personal profile
Due to Facebookâs privacy policy youâre not able to use the plugin to display all of your posts from a personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons. You may have limited success in displaying certain posts from a personal profile but most posts are not able to be displayed.
The easiest way to check whether youâre trying to display posts from a personal profile instead of a page is to view your page on Facebook and see whether you have âFriendsâ, âLikesâ or âMembersâ. Profiles have âFriendsâ, pages have âLikesâ and groups have âMembersâ. If you have âFriendsâ then itâs not a page, itâs a personal profile.
Solution:
If youâre using the profile to represent a business, organization, product, public figure or something else other than yourself, then weâd advise converting your profile to a page per Facebookâs recommendation: http://www.facebook.com/help/175644189234902/, as there are many advantages to using pages over profiles. It is in fact against Facebook policies to use a profile to represent something other than yourself (see âWhy should I convert my profile to a pageâ in the link above).
Once youâve converted to a page then the plugin will be able to retrieve and display all of your posts.
Your post limit might be set too low
Some posts are filtered out by the plugin as they arenât useful, such as â__ commented on their own statusâ, or if you are choosing to only show certain post types. If the post limit isnât high enough then there may not be any relevant posts to display.
Solution:
Try increasing the post limit for the feed to be 10-15 higher than the number of posts you are trying to display. This setting is located under Facebook Feed > All Feeds > select Edit for the relevant feed > Settings > Advanced > API Post Limit. The maximum post limit is 100.
You may be hiding all elements in the feed.
Check in the following location that all checkboxes aren’t unchecked: All Feeds > Select a feed > Posts > Edit Individual Elements.
Error: Unsupported get request. Code 100. Type: GraphMethodException
You may be using a Facebook ID from a personal profile
The easiest way to check whether youâre trying to display posts from a personal profile instead of a page is to view your page on Facebook and see whether you have âFriendsâ, âLikesâ or âMembersâ. Profiles have âFriendsâ, pages have âLikesâ and groups have âMembersâ. If you have âFriendsâ then itâs not a page, itâs a personal profile.
Solution:
Due to Facebookâs privacy policy youâre not able to use the plugin to display all of your posts from a personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons. You may have limited success in displaying certain posts from a personal profile but most posts are not able to be displayed.
If youâre using the profile to represent a business, organization, product, public figure or something else other than yourself, then weâd advise converting your profile to a page per Facebookâs recommendation: http://www.facebook.com/help/175644189234902/, as there are many advantages to using pages over profiles. It is in fact against Facebook policies to use a profile to represent something other than yourself (see âWhy should I convert my profile to a pageâ in the link above).
Once youâve converted to a page then the plugin will be able to retrieve and display all of your posts.
Your Facebook page may have restrictions on it
The feed youâre trying to display has to be a publicly accessible page. If your page has any restrictions on it (age or location) then it means that users are forced to sign into Facebook in order to view your page. This isnât desirable for most pages as it means that it isnât accessible by people who donât have a Facebook account and that your page canât be crawled and indexed by search engines.
An easy way to determine whether your page is set to public is to make sure youâre signed out of your Facebook account and then try to visit your page. If Facebook forces you to sign in to view your page then it has a restriction on it.
Solution:
You can remove any restrictions by logging into your Facebook account and going to the Settings for your page. You can then remove any Country Restrictions and Age restrictions (see screenshot). Once removed this will allow the Custom Facebook Feed plugin to access and display your posts.
Your Facebook page might not be published
When creating a new Facebook page it isnât actually published publicly until you click âPublishâ at the top of your page. If it isnât published then the plugin isnât able to retrieve your posts.
Solution:
Check the top of your page to see whether there is a âPublish my pageâ or similar button.
Your Facebook Group may contain Buy or Sell type posts
The Facebook API does not provide any information for Buy & Sell post types, and as such, it will cause an API Error 100 â Unsupported Get request error. For further information on how to fix this, please see here.
If youâre still having trouble displaying your posts after trying the common issues above then please contact support for assistance.
Error: (#2) Service temporarily unavailable
Facebookâs API may be temporarily down
Facebookâs API may be unreachable temporarily. Try waiting a few minutes and then trying again. You can clear the plugin cache and force the plugin to check the Facebook API again by going to Facebook Feed > Settings > Feeds > click Clear All Caches. You can also do this for an individual feed by going to Facebook Feed > All Feeds > click Edit for the feed > Settings > click Clear Feed Cache.
Error: (#803) Some of the aliases you requested do not exist
The Facebook page ID youâre using is not correct or invalid
Follow the directions on this page carefully to ensure that youâre using the correct Facebook ID. If unsure, try removing your current page source and redo the connection process.
Error: (#803) Cannot query users by their username
You may be using a Facebook ID from a personal profile
The easiest way to check whether youâre trying to display posts from a personal profile instead of a page is to view your page on Facebook and see whether you have âFriendsâ, âLikesâ or âMembersâ. Profiles have âFriendsâ, pages have âLikesâ and groups have âMembersâ. If you have âFriendsâ then itâs not a page, itâs a personal profile.
Solution:
Due to Facebookâs privacy policy youâre not able to use the plugin to display all of your posts from a personal profile, only from a public page, as posts from a personal profile are protected for privacy reasons. You may have limited success in displaying certain posts from a personal profile but most posts are not able to be displayed.
If youâre using the profile to represent a business, organization, product, public figure or something else other than yourself, then weâd advise converting your profile to a page per Facebookâs recommendation: http://www.facebook.com/help/175644189234902/, as there are many advantages to using pages over profiles. It is in fact against Facebook policies to use a profile to represent something other than yourself (see âWhy should I convert my profile to a pageâ in the link above).
Once youâve converted to a page then the plugin will be able to retrieve and display all of your posts.
Error: Invalid OAuth access token
Your Access Token is either incorrect, invalid, or expired
If youâre using your own Access Token then the easiest way to check whether it works is to test it in the Facebook Access Token Debugger. Paste the Access Token in the field and click Debug to see whether or not itâs valid, and for which page IDs the Access Token is valid. If you get an error message, the page ID is missing or is missing the pages_read_engagement âscopeâ, your token is invalid.
Solution:
To fix this issue, first ensure you have the latest version of the plugin. If not, update the plugin to the latest version (you can find the latest version numbers in the change logs here: Pro, Free). Then, update your Page Source in the Settings tab for the specific feed. If youâre having an issue updating the plugin then please see this FAQ.
Error: Server configuration issue
A PHP setting needs to be enabled on your server
In order to retrieve your posts from Facebook, the plugin requires a few basic PHP modules which are enabled on the majority of web servers by default. If these are disabled on your web server then it may be the cause of the problem. You can check this by going to WordPress Dashboard >Â Facebook Feed and clicking on the Help button in the upper right corner of the page. Then scroll down to your System Info section and click Expand. In the section labeled ## SITE/SERVER INFO: ##Â you should see the three items and whether they are active:
- PHP allow_url_fopen
- PHP cURL
- JSON
Solution:
If JSON is marked as No, then this means that JSON isnât running on your website server. You should contact your web host to request that they turn this on as it is required in order to use this plugin and many others.
If both PHP allow_url_fopen and PHP cURL are marked as No then it means that both of these PHP extensions are disabled in your serverâs php.ini file.  If you are familiar with editing this file then you can enable one or both of them yourself, otherwise, itâs recommended that you contact your web host and request that they enable one or both of these extensions on your server.
If only one of either PHP allow_url_fopen or PHP cURL is marked as No then the plugin should still function as expected, but if PHP cURL is marked as No the image resizing and GDPR functionality will not work.
A server security setting may be blocking your site from connecting to Facebookâs API
If youâve gone through the troubleshooting steps above and your Facebook Page works in the demo then there may be an issue with your site connecting to the Facebook API. This is usually caused by a security setting on your websiteâs server and can be remedied by your hosting support team. Please see this FAQ for more information and steps on how to solve this.
Post limit set too high
The Facebook API doesnât like it when too much data is requested in one go. If you have the number of posts or post limit setting set too high then it may be causing a Facebook API error and returning no posts. If the number of posts or your post limit is 100 (maximum) or more, try reducing it to see whether posts then appear. The setting is located under Facebook Feed > All Feeds > select Edit for the relevant feed > Settings > Advanced > API Post Limit.
Request method issue
Due to server configuration or security settings, itâs possible that the request method that the plugin uses to retrieve your posts is failing either permanently or sporadically. If this is the case then usually the plugin will fall back to using an alternative method, but on some rare occasions, this isnât the case. Ensure your host is not blocking access to api.facebook.com or graph.facebook.com.
Error validating application. Cannot get application info due to a system error.
Your Access Token is either incorrect, invalid, or expired
If youâre using your own Access Token then the easiest way to check whether it works is to test it in the Facebook Access Token Debugger. Paste the Access Token in the field and click Debug to see whether or not itâs valid, and for which page IDs the Access Token is valid. If you get an error message, the page ID is missing or is missing the pages_read_engagement âscopeâ, your token is invalid.
Solution:
To fix this issue, first ensure you have the latest version of the plugin. If not, update the plugin to the latest version (you can find the latest version numbers in the change logs here: Pro, Free). Then, update your Page Source in the Settings tab for the specific feed. If youâre having an issue updating the plugin then please see this FAQ.
Error: Unauthorized source IP address
Unauthorized source IP address
This error message means that your web serverâs IP address has been blacklisted by Facebook, most likely because someone else using the same IP address has violated the Facebook Terms of Service. If youâre on a budget web hosting plan then you most likely share your web server with hundreds, if not thousands, of other websites. As you all share the same IP address then if one of those websiteâs has the IP address blacklisted/blocked by Facebook then all of the websites on the server are also blocked. The only way around this is to contact your web hosting company and ask them to either change your IP address or move you to a different web server.
Error: Please reduce the amount of data youâre asking for, then retry your request
Post limit set too high
The Facebook API doesnât like it when too much data is requested in one go. If you have the number of posts or post limit setting set too high then it may be causing a Facebook API error and returning no posts. If the number of posts or your post limit is 100 (maximum) or more, try reducing it to see whether posts then appear. The setting is located under Facebook Feed > All Feeds > select Edit for the relevant feed > Settings > Advanced > API Post Limit.
Error: (#200) This call requires a Page access token
You need to obtain a âPageâ Access Token by following these directions
Error: Error validating Access Token. The session has been invalidated because the user changed their password of Facebook has changed the session for security reasons. Type: OAuthException. Code: 190
Your Access Token has become invalid due to changing the password on your account.
To solve this you’d need to reconnect your account to refresh the source. Edit an existing feedâs sources under Facebook Feed > All Feeds > click Edit for the relevant feed > Settings > Sources > Change and follow the connection process. This will then provide you with your own Access Token.
(#100) Tried accessing nonexisting field (fan_count) on node type (Group). Type: OAuthException. Code: API Error 100
Incorrect feed type selected
If you are trying to display a feed from a Facebook group then ensure that you select the correct feed source, Group when creating your feed. If you want to change the source for a specific feed do this under Facebook Feed > All Feeds > click Edit on the relevant feed > Settings > Sources and ensure you have the correct Group source.
Error: Error validating access token: The user is enrolled in a blocking, logged-in checkpoint. Type: OAuthException. Code: 190
Issue with user account
This error means that thereâs an issue with the Facebook account youâre using to try to log in via our plugin. This typically happens due to Facebook flagging your account for suspicious behaving or violations of their terms. This error isnât related in any way to our products, but is an issue with your Facebook account itself and so needs to be resolved with Facebook before you can use your account to log in via our plugin. Often, this issue occurs when your Facebook user account has failed a security checkpoint and you will need to log in at https://www.facebook.com or https://m.facebook.com to correct the issue.
Some common reasons which might trigger this issue:
1) Your username does not appear to be your real name. See this link for more information.
2) Suspicious account activity or your account was hacked
3) You violated Facebookâs platform policies
4) Running inappropriate/flagged images or videos on a page
5) Running inappropriate/copyrighted content in ads
There are other reasons your Facebook account might have this issue, but these are the most common ones.
Some suggested steps to help resolve this:
1) Delete the browser history and cookies for your browser.
2) Log in to https://www.facebook.com or https://m.facebook.com from that browser (if the issue is related to pages or ads, you may need to log into the Business Manager instead).
3) This should load a new page with a security checkpoint that lists the actions you need to take to address the root cause that blocked the account in the first place (verifying your ID, removing inappropriate content, etc..).
4) If the checkpoint does not appear, or renders it as blank (a common problem reported), see this guide on the Facebook forums for a possible workaround.
5) Once you have completed the necessary steps given by the checkpoint (or followed any steps provided by Facebook support) then your account will then be unblocked and you should be able to use your account as normal to authorize our plugin.
If the above steps donât work, then you would need to contact Facebook support as we are unable to assist with issues with Facebook accounts themselves.
If you’re still having trouble displaying your posts after trying the common issues above then please contact support for assistance.
