Crawler Ingestion

Facebook can automatically ingest an Instant Article by fetching a self-hosted, public document containing the Instant Articles markup.

Our Crawler visits your article when someone shares its URL for the first time on Facebook. If it finds the ia:markup_url meta-tag, it will automatically ingest the Instant Article from the provided URL.

For existing articles created by the Crawler Ingestion method, if our crawler doesn't detect this tag, it will delete the corresponding Instant Article from your Facebook Page.

Adding the meta-tags

On your web article, you'll need to reference two important meta tags:

  1. The ID of the Facebook Page as the destination of the imported Instant Articles content:
    <meta property="fb:pages" content="{PAGE_ID}">
    Note: If you have multiple Page IDs in this tag, make sure that the first one corresponds to the Page ID used to import Instant Articles content.
  2. The URL (self-hosted, public) containing the Instant Article markup for the respective page:
    <meta property="ia:markup_url" content="{URL}">

Optionally, you can specify property="ia:markup_url_dev" instead in order to have the markup imported to your Development Feed for testing purposes.


To update Instant Articles created by the Crawler Ingestion method, follow the instructions in Updating Objects.

Next Steps

  1. Customize the Style of Your Instant Articles.
  2. Follow Our Blog. Sign up for notifications to learn about Instant Articles news and updates.
  3. Monetize Your Instant Articles. Use your own direct sold ads or Audience Network (or both).
  4. Add Interactive Design Features. Delight your readers with Instant Articles’ unique features.
  5. Use Analytics in Instant Articles. Learn how to embed your own or third-party trackers.
  6. Troubleshoot Any Issues.