Beginner's Guide for WordPress / Start your WordPress Blog in minutes

How to Setup Facebook Instant Articles for WordPress (Step by Step)

Have you heard about Facebook Instant Articles and want to add them to your WordPress site?

Instant Articles are excellent for delivering content quickly to Facebook users. They load 10 times faster and use a mobile format. This helps provide an exceptional user experience and increases your followers.

In this article, we will show you how to easily setup Facebook Instant Articles for WordPress.

How to set up Facebook instant articles for WordPress

What are Facebook Instant Articles?

Instant Articles is a Facebook feature that allows you to load your content 10 times faster by using a customized mobile format. It is based on the same technology used in Facebook apps for mobile devices.

Instant Articles load up to 10 times faster than a normal web page. This incredible boost in speed provides a better user experience for mobile users.

Many popular media sites like BuzzFeed, TechCrunch, Mashable, and countless others are using it on their websites. You can easily spot instant articles in your Facebook feed by the lightning bolt icon.

Pros and Cons of Facebook Instant Articles

Like everything else, there are some advantages and disadvantages of using instant articles on your website.

Pros of Using Facebook Instant Articles

  • Faster load time means a significant improvement in user experience.
  • Due to speed, users are more likely to share your content.
  • Access to monetization options through Facebook Audience Network.
  • Boosted Facebook Page Reach.
  • Facebook’s massive user base can bring a new wave of traffic to your site.

Cons of Using Facebook Instant Articles

  • Users will not see your full WordPress website layout including sidebars. It will hide your useful widgets, email list forms, and everything else that is not part of the article.
  • You may see a drop in advertising revenue, as Facebook instant articles limit the advertisers and the number of ads you can show on an article.
  • You can use some images and videos in your article, but Facebook instant articles will limit that as well.
  • Most shortcodes, custom fields, and other WordPress blog features will not be displayed in your articles.

Considering the pros and cons of using Facebook Instant Articles, it is a mix bag for publishers. It actually depends on the type of content you produce and your business goals.

If you’re a news media site, then it makes sense for you to add it. If you’re a business website, then it may not be a huge difference maker.

What Do You Need to Enable Facebook Instant Articles in WordPress?

There are a few requirements for setting up Facebook Instant Articles on your WordPress site. You need a:

  • Facebook page for your WordPress website.
  • At least 10 or more articles on your website.
  • Instant Articles for WP plugin (We will show you how to set it up later in this article).

Having said that, let’s get started by applying for Facebook Instant Articles.

Signing up for Facebook Instant Articles

First, you need to visit the Facebook Instant Articles website and click on the ‘Start earning’ button to get started.

Get started with instant articles

Next, log in to your Facebook account or create a new one if you don’t have an account.

After logging in, you’ll see the Creator Studio. Facebook will now ask you to select a page under the ‘Monetization’ tab.

Go ahead and select your Facebook Page for your website and click the ‘Set Up’ button.

Set up instant articles

After that, you’ll need to complete setup tasks and submit your page for review.

First, you’ll need to agree to the terms and conditions.

Next, click the ‘Begin’ button to Add 10 production articles for review.

Complete set up tasks

When you click the button, more options will appear.

You need to prove the ownership of your website by claiming your URL. Go ahead and click the ‘Claim’ button in front of the Claim domain option.

Claim your domain

Facebook will show you a code snippet that you’ll need to add to your WordPress website.

You can add up to 10 websites for Facebook Instant Articles.

Copy the meta tag

You need to copy the code and insert it into the <head> section of your WordPress site.

There are two ways you can add this code to your website.

You can edit the header.php file in your child theme and paste the code just before <head> tag.

However, if you are not using a child theme, then you can use Insert Headers and Footers plugin. For more details, see our step-by-step guide on how to install a WordPress plugin.

After activating the plugin, go to Settings » Insert Headers and Footers page from the WordPress dashboard and paste the code into the header section.

Insert code in the header

Click on the Save button to store your changes.

Once you have added the code to your website, you need to switch back to the Creator Studio tab and click the ‘Claim URL’ button.

Click the claim URL button

A popup window will now appear.

Simply enter your domain and click the ‘Claim’ button. If your site is still under development, you can enable the ‘This is a development URL’ option.

Enter your site URL

Next, you’ll see your domain under the ‘Approved domain URLs’ field once it’s approved.

Go ahead and click the ‘Confirm’ button.

Confirm your domain

The next step is to add an Instant Articles RSS feed for your website.

To do that, scroll down to ‘Add production articles’ and simply click the ‘Add’ button.

Add production articles

On the next screen, you’ll see a dropdown menu where you can select how you’d like to add production articles.

Go ahead and click the ‘Add articles’ dropdown menu and select the ‘Add with RSS feed’ option.

Add with RSS feed

A popup window will now appear with production RSS feed information.

Here, you’ll need to enter the RSS feed URL.

Enter production feed URL

To create an RSS feed URL, you can head back to your WordPress website dashboard and generate an Instant Article feed.

First, install and activate the Instant Articles for WP plugin. If you need help, then please see our guide on how to install a WordPress plugin.

Upon activation, you can head over to Instant Articles from your WordPress admin panel and enter your Facebook Page ID. You can find the page ID in the Claim domain section in Creator Studio.

Enter your Facebook page ID

After entering the page ID, don’t forget to save the settings.

The plugin will generate an instant articles feed for your WordPress site.

You can find the feed by adding /feed/instant-articles after your site’s URL, like this:

Copy your instant articles feed URL and switch back to your Facebook Creator Studio tab. Next, enter the RSS feed URL and click the ‘Save’ button.

Enter production feed URL and save

Facebook will show you a success message that your feed is added.

Setup Style and Branding for Your Instant Articles

Next, you can edit the style of your Facebook Instant Articles.

Simply go to the ‘Configure article styles’ option under Add 10 production articles for review and click the ‘Configure’ button.

Configure article styles

After that, you can change the look and feel of your articles.

Go ahead and click the ‘Add style’ button.

Add article style

This will open up a popup where you can customize the default style of Instant Articles.

There are options to upload your website logo and edit the style of your title, body text, byline, subtitle, and more.

The best part is that you can see a live preview of the change you made in the window on your right.

Customize your instant articles

After making the changes, don’t forget to click on Save and then click on Done.

Submit Your Instant Articles Feed for Review

Before submitting your Instant Articles feed for review, you need to make sure that you have at least 10 articles in your Instant Articles feed.

If you have already published more than 10 articles on your website, but the feed is not showing all of them, then you need to edit your last 10 articles and simply click on the update button.

Once you are sure that you have 10 articles in your Instant Articles feed, you are now ready to submit them to Facebook for review.

Submit for review

If there are no errors with your Instant Articles feed and you’ve completed all the required tasks, then you will see a ‘Submit for review’ button. Go ahead and click on this button to send your feed for review.

That’s all, Instant Articles will become available for your website once the Facebook team has reviewed and approved your feed.

Bonus: Track Facebook Instant Articles in Google Analytics

Now that you’ve successfully setup Facebook Instant Articles in WordPress, you should also see how they’re performing.

By tracking their performance in Google Analytics, you can see which articles get the most traffic and how users interact with your content.

The easiest way of tracking Facebook Instant Articles is through MonsterInsights. It’s the best Analytics solution for WordPress and let’s you set up Google Analytics without editing code.

Do note that you’ll need MonsterInsights Pro version because it includes the Facebook Instant Articles addon and other advanced tracking features. There’s also a MonsterInsights Lite version that you can use for free.

First, install and activate the MonsterInsights plugin. For more details, please see our guide on how to install a WordPress plugin.

Upon activation, you’ll see the MonsterInsights welcome screen in your WordPress dashboard. Go ahead and click the ‘Launch the Wizard’ button to connect your WordPress site with Google Analytics.

Launch setup wizard

You can follow our step by step guide on how to install Google Analytics in WordPress for more information.

After that, head over to Insights » Addons from your WordPress dashboard and navigate to the ‘Facebook Instant Article’ addon.

Install Facebook instant articles addon in MonsterInsights

Next, click the ‘Install’ button and the addon will automatically activate.

That’s it, there’s no need for additional configuration. MonsterInsights will now start to track your Facebook Instant Articles in Google Analytics.

Facebook Instant Articles Troubleshooting Tips

Facebook requires that your Instant Articles feed to match the specifications described on their developer website. Instant Articles for WP plugin handles that part for you.

However, depending on the theme or plugins you are using on your site, you might see some errors or warnings. An easier way to troubleshoot those errors is by editing a post and scrolling down to the Facebook Instant Articles meta box below the post editor.

Instant article warning in WordPress

Most of the errors are caused by plugins or themes adding content into your posts that are not supported by transformer rules used by Instant Articles for WP plugin.

You can create your own custom transformer rules. Refer to the plugin’s documentation to learn how to add your custom transformer rules.

However, we feel that it would be difficult for most beginners to do that on their own, so you may need a developer. You can try to configure your other plugins and themes and stop them from adding content blocks to your posts.

Incorrect URLs

If you are continuously getting an Empty Feed error when submitting your Instant Articles feed, then check the URL you are trying to add.

These are two different URLs, and depending on your WordPress setup, entering the incorrect URL may result in a 404 error.

If you are still seeing the empty feed error, then try updating the last ten posts on your site. This will change their time modified and will add them to the feed.

We hope this article helped you set up Facebook Instant Articles for WordPress. You may also want to see our list of 40 useful tools to manage and grow your WordPress blog and how to start an online store.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

Disclosure: Our content is reader-supported. This means if you click on some of our links, then we may earn a commission. See how WPBeginner is funded, why it matters, and how you can support us. Here's our editorial process.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!

Reader Interactions

106 CommentsLeave a Reply

  1. This says nothing about actually adding ads form the audience network though which is the hardest part.

    • That topic would likely be best for a different article but thank you for the suggestion :)


  2. I have created a website recently. it’s just been 20 days. And also i have created a Facebook page 4 days ago. my website has around 13 posts and on facebook page i have published 2 posts.
    So is it something like that my facebook page should be 90 days old so that my page can be eligible for Facebook instant.?

    • You do not need a specific hosting plan for Facebook Instant articles, for this method you would just want to be sure your site is a site.


  3. This post really inspired for me . Therefore, try it especially if you want to increase traffic to your site. Take advantage of Facebook’s massive user-base to share your work.

  4. The provided URL is not being accepted because the site has minimal readership, which violates the Instant Article Policies. Please provide a different URL.

    this error show for my website. in my website 80+ article post. please tell me what to do.

    • Most of the stuff is still accurate and applicable. You should have no problem following it. The only difference is that you no longer need to create a Facebook Developer App to do it. Essentially, Facebook made it easier.

  5. Thanks. I was looking in google about fb instant articles and also tweeted. But I dont think this will give more traffic to blog.

  6. Hiiii;
    thanks for such a good post i have successfully setup the instant article.But i am getting a problem that my posts don’t show images on instant article and some post don’t show ads.
    can you please help me..

  7. Hello, I have problem. When I try to activate Word press Instant Article plugin I see this: “No space left on device (28) in Unknown on line 0 Warning: Unknown: Failed to write session data (files). Please verify that the current setting of session.save_path is correct (/var/lib/php/session) in Unknown on line 0” ?

  8. How to solve this error while claiming the URL in Step 4 :
    “The fb:pages tag on the url doesn’t contain this page’s id. The url has fb:pages tag but they don’t have this page’s id. Please work with your developers / webmaster to add this tag to your website.”

  9. thanks for this tutorial…
    i am facing problem in claiming my url
    whenever i try to claim my url, it shows something like this.

    “We tried going to your page and checking the page tags present, but there was a failure.”

    please tell me what to do now.

  10. Please help. It seems the Instant Article plugin for WP has been updated and I was unable to follow your tutorial to set up the Plugin on my WordPress dashboard as the setting page looks totally diferent from what you showed on your images.

    • Same is happening with me.. in first page of is asking me for page id
      Placement id.
      Ad size and lots more things..
      and when along with this error when i am entering that feed url then in result that url is showing full coding in result..
      plz help me out

  11. Hello,
    thank you for your tutorials
    when installing the plugin, it gives me this error!

    Installation failed: Could not copy file. fb-instant-articles/vendor/facebook/facebook-instant-articles-sdk-php/src/Facebook/InstantArticles/Transformer/Warnings/NoRootInstantArticleFoundWarning.php

  12. greetings… WPBEGINNER SUPPORT, i appreciate this post.. very educative.
    i was able to submit for review following your steps.
    please i need help on the instant article plugin for wp, i could not submit for review, when ever i try submitting, i always get ” Permission Error”.
    i wish to know if that will also be needed after the review from facebook team? Thank you very much……….. you are so kind.

  13. In the WordPress instant article plugin, i am facing a error while logging into facebook. “ERROR – Facebook SDK returned an error: Couldn’t resolve host ‘”
    and when it is directed to facebook, this is the messga i get, “Submit for Login Review
    Some of the permissions below have not been approved for use by Facebook.
    Submit for review now or learn more”
    Please help me.

  14. The fb:pages tag on the url doesn’t contain this page’s id. The url has fb:pages tag but they don’t have this page’s id. Please work with your developers / webmaster to add this tag to your website.

    I am getting this error continously and unable to claim the website. plz help

  15. Hi, I use an advertising script I have inserted in the dedicated section of the wordpress plugin code . The posts that are published show instead of advertising a blank, why?

    Thank a lot for your support
    Best regards

  16. Hi!

    First of all, thanks for this article! :-)

    But, I’m with a problem when you say:

    Simply install and activate the Instant Articles for WP plugin. Upon activation, the plugin will generate an instant articles feed for your WordPress site.

    In my case, my RSS url doesn’t work:

    Do you know why?

    Thanks a lot, dude!

      • I did that and one more thing…

        I went to my Facebook Page > Publishing Tools > Published Posts at the top of the sidebar.

        From there, I located my most recently shared blog post and clicked on it to open the Post Details box.

        Then under the little down arrow that is your normal edit button on a post, I clicked on ‘Refresh Share Attachment’

        That was the thing that made it all work. :)

  17. Hi Admin. Thanks for nice step-by-step tutorial. I just want to ask, how to add related articles at the bottom of instant articles. it is automatically show only for visitor or need some code to make them appear?. Thanks.

  18. Thanks for this great post. I followed your steps and i managed to set it up on my fb page. But I have a problem.

    I have customize the styles in with facebook style editor and everything was okay when I review it with fb pages apps. But the problem is, when i share the articles, the published post used ‘default’ style instead of the other one. Please help me.

  19. In my WordPress account under every post its written that your article is being submitted with 0 warning but at facebook publishing tools I still can’t press the submit button it says
    We have automatically detected one or more common errors that need to be fixed before you can submit for review.
    Missing Logo
    All articles must include a logo, which you can upload in the Style Editor.
    and list of my posts
    Hope You Could Help me out

  20. No matter what changes I make, I cannot submit articles.There has to be a better plugin than this one. It;s always buggy or not compatible with “this version of WordPress” I got it right the first time with a client;s site, but after I cannot publish any other new articles. Tried to set up my site, I can’t submit articles at all.

    My head hurts.

    • I am replying to my own comment (weird) because I fixed the problem I was facing. Missing logo. My articles were fine, but no matter how many style editors I created, I couldn’t fix the ‘missing logo’ error. What I did was go back to the ‘default’ or ‘preset’ style editor and customized it. Voila! Articles were submitted. Problem solve. I am still looking into it though. Maybe it’s me, but I find this plugin a wee bit buggy

  21. Hi, I am running multiple lingual website. I want to run the instant article both of the above domains. How is it possible? Do I need to merge two rss feeds. Need your suggestion.

  22. Hello, WB Team.

    Great and detailed guide on Facebook InstantArticle.

    Sir, I am also using this tool for my website. My posts have been submitted to InstantArticle with some errors. I fixed some of those. But, I can’t find solution for this,

    “no rules defined for in the context of InstantArticle”.

    Sir how to fix this problem. Please help me.

  23. Hi, very helful guide but my blog begins with https not http. after i insert the code given by facebook in header, i could be claimed the url but when i tried tu insert the url begin with http it’s fine

    i accessed my url but it said that the url was not found because my blog automatically direct http to https

    how to solve this, thanks :)

  24. All the links that I share are being converted into instant articles. I want only selective articles to be published as instant articles. I use affilate links in some posts which dont wirk in instant articles. Please help!

  25. Next, log into your Facebook account
    Log in with Facebook to finish connecting the Instant Articles Plugin to your account.

    Login with Facebook

    after This, it is not logging in just it reloads nothing happens
    sir can You Guide me Please regarding this problem

  26. This is by far the most useful resource I’ve found for adding FB Instant Articles.

    One question, do you have a tutorial for excluding certain post categories from your Instant Articles feed?


  27. on this step “The plugin’s settings page will now show you a login with Facebook button.” when i click on login with facebook the page reloads and nothing happens please help me asap

  28. hello team,
    great material, thks. I hv created everythg and it all seems well however on the post page this error:
    *This post will not be submitted to Instant Articles due to a rule created in your site.*
    How can i go over this thks.

  29. hi thanks for this article but the instant article cant recognize short code because i use it to embed my videos is there a way around this pls

  30. hi i have done all the processes but i keep getting this error at the final stage : Permissions error pls how can i fix this

    • You can check what causes this issue if you look at Instant Articles settings on Facebook. For me, the page logo was missing. Once I uploaded that, the Permissions Error went away.

  31. I’ve just been approved for Facebook Instant Articles. I’m using the “Instant Articles for FB” Plugin to publish my Instant Articles. I just published blog Post and it shows up as Live in Instant Articles. How do I get the Instant Articles link? I don’t see it anywhere and I don’t have any idea how to access it. Any help you can provide would be appreciated.

    Thank you,
    Garland Smith

Leave A Reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.