Crawler Ingestion

Facebook can automatically ingest an Instant Article by fetching a self-hosted, public document containing the Instant Articles markup or the rules to transform the HTML content.

To ingest the content using the crawler option you can use two different approaches:

  1. Instant Article markup (ia:markup_url)
  2. Rules reference (ia:rules_url)

Instant Article markup (Option 1)

Our Crawler visits your article when someone shares its URL for the first time on Facebook. If it finds the ia:markup_url, 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.

Updating

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

Rules reference (Option 2)

Similar to Option 1, the Crawler visits your article when someone shares its URL for the first time on Facebook. If it finds the ia:rules_url meta-tag, it will automatically run the transformation using the specified rules, and then ingest the resulting Instant Article from the shared URL.

Adding the meta-tags

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

  1. The ID of the Facebook Page as the destination of the imported Instant Article:
    <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 the Instant Article.
  2. The URL (self-hosted, public) of the file containing the Instant Article markup for the web page being crawled:
    <meta property="ia:rules_url" content="{URL}">

Optionally, you can specify property="ia:rules_url_dev" instead in order to have the content transformed and ingested to your Development Feed for testing purposes.

Updating

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

Rules Editor

The Rules Editor is a standalone application that can help you to simplify the creation of the necessary rules to transform your HTML article. This tool allows locating elements by clicking on them, and the resulting rules can be exported. Please check its documentation for more details.

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.