Tech docs
Integration Docs
Repeated meta tags

Repeated meta tags

Specifying metadata information on your webpages is the second step of integrating with Parse.ly. (Jump to documentation about installing the tracking code if you don't have the tracker running yet!)

You can provide metadata in two different ways:

  • JSON-LD (recommended) - following open standards and schemas, metadata is included in a script tag. This metadata can also be used by other services (such as Google, for enhanced display in search listings).
  • 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. Metadata specified this way will only be used by Parse.ly.

Parse.ly'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.

#Example

Add tags like these to the <head> element of all tracked pages.

<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-titlePost or page title (article headline)
parsely-linkCanonical 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-urlURL of the image associated with the post/page.
parsely-typePage type - "post", "frontpage" or "sectionpage"
parsely-post-idString that uniquely identifies this post. Unless otherwise instructed by Parse.ly support, should be omitted in favor of parsely-link.
parsely-pub-datePublication date, as ISO 8601 UTC timezone string.
parsely-sectionSection the page belongs to (e.g. "Politics").
parsely-authorAuthor who wrote the post. This field can be repeated for each author in a multi-author post.
parsely-tagsString of comma-separated keywords associated with the post (e.g. "basketball, NBA, LeBron").
parsely-metadataArbitrary data to attach to post. Must be a valid JSON-serialized 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.

rocket emoji