#Legacy documentation

This documentation refers to an earlier format of proprietary metadata. While crawlers will continue to support this format, new projects should instead use the recommended and standard JSON-LD format.

Specifying metadata information on your webpages is the second step of integrating with (Jump to documentation about installing the tracking code if you don't have the tracker running yet!)'s crawlers don't execute javascript, so regardless of which metadata format you choose, the information must be accessible in the actual source of the page. For more, check out our detailed crawler information.


<meta name='parsely-page'
    content='{"title": "Zipf\u0027s Law of the Internet: Explaining Online Behavior",
        "link": "",
        "image_url": "",
        "type": "post",
        "post_id": "57821746552",
        "pub_date": "2013-08-15T13:00:00Z",
        "section": "Programming",
        "authors": ["Alan Alexander Milne"],
        "tags": ["statistics","zipf","internet","behavior"]

For the purposes of readability the value of the content attribute in the code above is indented and attributes come each on a new line. This is not valid HTML and in production environment the value of the content attribute should be all in a single line.

#Field description

titlePost or page title (article headline).
linkSpecifies the canonical URL for post or page. For page groups, like galleries, it should always point to the main page. For accurate data, canonical urls specified in other metadata tags (such as <link rel="canonical"> and <meta property="og:url"> tags) must match, resolve, or redirect to this url. For more information, please refer to our documentation on shares integration.
image_urlURL of the image associated with the post/page.
typePage type - "post", "frontpage" or "sectionpage"
post_idString that uniquely identifies this post. Unless otherwise instructed by support, should be omitted in favor of link.
pub_datePublication date, as ISO 8601 UTC timezone string.
sectionSection the page belongs to (e.g. "Politics").
authorsList of post authors.
tagsList of tags associated with this post.
metadataArbitrary data to attach to post. Must be a valid JSON string. See documentation about custom metadata.

#Technical Caveats

Escape single and double quotes in JSON item values. Single quotes should be replaced with the JSON unicode equivalent \u0027. Double quotes should be escaped with a backslash symbol like this: \".

Values in parsely-page will appear literally inside Analytics. String values supplied here, specifically title, author, and section, will appear in analytics exactly as they are specified in the tag. As a result, make sure to use proper capitalization and specify the values as you expect them to appear.

The parsely-page metadata tag cannot be loaded asynchronously. The crawler will not execute JavaScript. It must be able to access the metadata tag from the results of a single GET request.

#Content behind pay walls

If you have content that is accessible only after logging into the system, you should coordinate with support team to arrange for a special login account, only accessible to our Crawler. The credentials for this account will only be used by the Crawler and will not be shared with anyone else.

Ready to get started with



rocket emoji