Skip to content

Network Syndication overview and configuration

To enable this feature for your dashboard, email

It’s common for large publishers or brands to publish the same content across multiple sites. makes it easy to understand how both the original content and the syndicated versions perform across the entire network.

In order to understand how content is distributed, requires all syndicated pages (and any “original” pages that may be syndicated) to have an additional metadata field that establishes a “network canonical URL.”

While it may seem redundant, you will need to have both a “URL” value and a “network canonical URL” value on the “original” or “parent” pages that will be syndicated. Just as the canonical URL is used to combine data across all URLs from a single site, the network canonical URL is used to group each of those combinations together. Note that the site where the network canonical URL originates from must be publicly accessible.

This property should be specified using the isBasedOn property in each page’s JSON-LD as illustrated in the example below.


<script type="application/ld+json">
    "@context": "",
    "@type": "NewsArticle",
    "headline": "Zipf's Law of the Internet: Explaining Online Behavior",
    "url": "",
    "isBasedOn": "",
    "thumbnailUrl": "",
    "datePublished": "2013-08-15T13:00:00Z",
    "articleSection": "Programming",
    "creator": ["Alan Alexander Milne"],
    "keywords": ["statistics", "zipf", "internet", "behavior"]

It’s easier to illustrate by example. Let’s say you have a network composed of sites,, and Site publishes That page is syndicated on the other sites at and The url and isBasedOn property of each version of the post should be set as follows:

Siteurl value (site)isBasedOn value (network)

Because each of the three pages share the same network canonical URL, they will be grouped together in network rollup and site group screens of the dashboard. Additionally, because the canonical URL and network canonical URL of match, can identify that version as the “original” and use that version of the metadata within network and site group views. Any cases where those URLs don’t match are understood to be syndicated versions.

One advantage of this system is that different versions of a syndicated article can maintain their own metadata on site-specific dashboards. For example, it’s common for syndicated versions to have a different headline than the original. Within the dashboard of each site, the url value will be used as the canonical URL. This means that on the dashboard, the headline (and any other metadata) provided on will be used for the post.

Alternative methods for specifying the network canonical

Via repeated meta tags

If you’re using repeated meta tags instead of JSON-LD to specify metadata, you can also provide the network canonical URL by including a <meta> tag with the name parsely-network-canonical.

The equivalent markup for the JSON-LD example above would be:

<meta name="parsely-network-canonical" content="">

Last updated: January 02, 2023

Last updated: January 02, 2023