Custom Metadata

Though the API attempts to provide all the data and metadata you may need for rendering site features, there may occasionally be pieces specific to you that would be useful to have in the API, that are not available in Parse.ly's data model. For these situations, we support a parsely-metadata META tag on your article pages, which can add arbitrary metadata to existing posts.

Add a META tag to your page with the name "parsely-metadata" and a content field which is a serialized (and, as needed, quote-escaped) JSON string. For example:

<meta name='parsely-metadata'
      content='{"type": "feature", "image_url": "http://cdn.site.com/img.jpg"}'>

Once that is done you can notify the Parse.ly team, who can trigger recrawling of your site -- this will fetch all post pages to sync up the parsely-metadata field with our database. This is to ensure old posts are backfilled with this metadata.

After that you will start receiving the metadata you sent in the metadata field in API. All data in your META tag will simply be passed through, as-is. Note that these values won't be displayed in your dashboard.

Technically, the metadata field can store any arbitrary string, but we recommend you format it as JSON. Also, this string is limited to 2,000 characters -- if it is longer than that, it is ignored.

Do you have an urgent support question?