Repeated meta tags

Specifying meta information in the page is the second step of the integration. Jump to documentation about the installing tracker code if you don't have the tracker code running yet!

You can add the meta information to your pages in three different ways:

  • JSON-LD (recommended) - the metadata is included in a script tag and thus simplifies escaping of the content (most of the time the serving framework's JSON converter will suffice). Please note: our crawlers don't run javascript, so the contents have to be in the actual source of the page.
  • repeated metatags (alternative) - if the CMS you are using has a way to provide page information as meta tags in the page header, then this might be a more convenient option.
  • parsely-page (deprecated) - legacy proprietary format that represents metadata as JSON. This has now been replaced with JSON-LD. The crawlers will keep supporting this format but new projects should prefer JSON-LD.

The Parse.ly meta tag is used to reliably identify information about the page, like the author, publishing date, title, and the section it belongs to. Add the tag to the <head> element of the tracked pages. The content parameter should be a JavaScript dictionary serialized to JSON.

Example:

<meta name="parsely-title" content="Zipf's Law of the Internet: Explaining Online Behavior" />
<meta name="parsely-link" content="https://blog.parse.ly/post/57821746552" />
<meta name="parsely-type" content="post" />
<meta name="parsely-image-url" content="https://blog.parse.ly/inline_mra670hTvL1qz4rgp.png" />
<meta name="parsely-pub-date" content="2013-08-15T13:00:00Z" />
<meta name="parsely-section" content="Programming" />
<meta name="parsely-author" content="Alan Alexander Milne" />
<meta name="parsely-tags" content="statistics,zipf,internet,behavior" />

Field description

parsely-title Post or page title (article headline)
parsely-link Canonical URL for post/page. For page groups like galleries, it should always point to the main article. For accurate data, the canonical urls for the social networks (link rel="canonical" and og:url) must match or resolve to this url. For more information, please refer to the documentation here.
parsely-image-url URL of the image associated with the post/page
parsely-type Page type - "post", "frontpage" or "sectionpage"
parsely-post-id String that uniquely identifies this post. When omitted, will fall back to the canonical link.
parsely-pub-date Publication date, as ISO 8601 UTC timezone string
parsely-section Section the page belongs to (e.g. "Politics")
parsely-author Author who wrote the post. This field can be repeated for each author in a multi-author post.
parsely-tags An array of tags associated with this post
parsely-metadata Arbitrary data to attach to post. Must be a valid JSON string. See documentation about custom metadata

Technical Caveats

Escape double quotes in JSON item values. Double quotes should be escaped with a backslash symbol like this: \".

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

The Parse.ly meta tags cannot be loaded asynchronously. The Parse.ly crawler will not execute JavaScript. It must be able to access the meta tags from the results of a single GET request.

Do you have an urgent support question?