Related Articles

You can include links to related articles in the 'More from' footer section and in-line in an article.

All links to related articles must direct to your own publication. Third-party referrals are not allowed. Links may lead to other Instant Articles but don't have to. You can include sponsored content, which must be specified with the data-sponsored attribute.

Note: Horizontal swipe for more articles is separate from the Related Articles units discussed here. All articles in the horizontal swipe selection are chosen algorithmically. At this time publishers do not have control over the articles in that section.

You can control which links are included in the 'More from' section at the end of your articles. The information is defined with the op-related-articles class in the <footer> block.

Specify a maximum of four links. If you include fewer than four, Facebook will automatically populate the remaining links. Only articles from your own publication will be included.

The 'More from' module will appear as the final element in the footer, after credits, copyright or any other information.

In-line

To include links to related articles in-line, include a list of links with the op-related-articles class within the body of the <article> block.

You can include a maximum of four links in this list. Unlike in the footer, Facebook will not automatically populate the remaining links if you include fewer than four.

The list of links will appear in the article at the position where it was included in the markup. You can optionally specify a title, which will appear as a heading for the list.

Options

Name Description Definition

Sponsored

Specifies whether this link leads to sponsored content.

Include a data-sponsored attribute on the <li> list item element and set the value to true if the link leads to sponsored content. Omit the attribute or set the value to false if it does not.

Title (in-line only)

Specify the title of the in-line list.

Include a title attribute on the <ul> list element if you want to add a heading to the in-line list of articles. If you do not include a title, the list will be rendered with no heading.

Examples

To specify all of the links in the 'More from' section, include a list with the class op-related-articles in the <footer> section with a <li> element for each link.

If the link leads to sponsored content, set the data-feedback attribute of the <li> element to true:

<footer>
  <ul class="op-related-articles">
    <li><a href="http://example.com/article.html"></a></li>
    <li data-sponsored="true"><a href="http://example.com/sponsored-article.html"></a></li>
    <li><a href="http://example.com/another-article.html"></a></li>
  </ul>
</footer>

To have Facebook automatically fill any remaining slots with links to your other articles, specify fewer than four links. If you leave out the list, Facebook will select all four articles.

<footer>
  <ul class="op-related-articles">
    <li><a href="http://example.com/article.html"></a></li>
    <li><a href="http://example.com/another-article.html"></a></li>
  </ul>
</footer>

In-line

To include a list of related articles in-line in your article, place a list of links within the article body, optionally specifying the title of the list.

<article>
  <p>A paragraph of body text.</p>
  <ul class="op-related-articles" title="Title of Related Articles List">
    <li><a href="http://example.com/article.html"></a></li>
    <li><a href="http://example.com/another-article.html"></a></li>
  </ul>
  <p>Another paragraph of body text.</p>
</article>