Back to News for Developers

A New Way to Report Instant Articles Bugs

July 18, 2017ByNatasha von Kaeppler

We're excited to introduce the new bug reporting tool for Instant Articles, an improved system for getting your development issues solved as you build out articles.

The new bug reporting tool is a curated, self-service solution that is an extension of Facebook's existing support tool. When you find a bug while developing your Instant Articles, use the tool to find out if other publishers have run into the same issue, or use it to tell us about the bug so we can help fix it. We're committed to responding to your report and resolving any new bugs you find within 30 days.

How the bug reporting tool works

When you find a bug the first place you'll want to look for answers is in the bug reporting tool on the developer website. You have these two options:

  • Search – Search for a previously reported bug.
  • Create – Create a new bug report.

Search for a Bug

Follow these steps to search for your bug:

1. Go to

2. Search.

In the search bar begin typing the bug you're looking for and check in the dynamic list of bug reports below if your issue has been logged.

3. View the bug details and subscribe.

If you see the bug you're looking for, click on it to see more details on the issue and the solution. You have the option to subscribe to the bug topic in the top right hand box labeled “Bug Info.”

Create a New Bug

If you can't find your bug after searching, follow these steps to report a new bug:

1. Go to

2. Report a new bug.

Click on 'Report new bug' at the top of the page on the right side.

3. Report a platform bug.

If you're prompted to choose between reporting a Facebook bug or a developer bug, select 'Yes, I found a Platform Bug' on the bottom right side of the pop-up window.

4. Specify Instant Articles bugs.

Select 'Instant Articles' in the bug types listed in the first column on the next page.

5. Choose your bug type.

Select the specific issue category that applies to your bug in the next list that appears.

6. Add detail to your bug report.

In the boxes below, add a title for your questions and provide enough detail in the description to allow us to begin debugging the issue. Be sure to also include your Page ID.

7. Keep your question confidential. (optional)

You can elect for your bug report to be kept confidential, in which case it will not appear in the search results when other Instant Articles developers look for bugs that have been submitted.

8. Submit.

Click the 'Submit' button to report your bug.

9. Track your report.

On the next screen you will see the bug you just reported, as well as a timeline that you can follow to know when the bug has been confirmed by the Facebook team, when the fix is ready, and when the bug has been resolved.

We're excited to continue supporting you as Instant Articles partners!