Metadata

Metadata gives search engines, social platforms, and other services the context they need to display your pages correctly. On Insites, you define metadata in the YAML front matter of a page and access it via Liquid in your layouts and partials.

Defining Metadata

Add a object to your page's YAML front matter with key-value pairs:

You can also add and edit metadata through the Instance Admin by navigating to CMS > Content, selecting a page, and opening the Metadata tab.

Accessing Metadata in Templates

Metadata is available in Liquid as . Use this in your layout to set HTML meta tags dynamically:

Open Graph and Social Tags

Open Graph metadata controls how your pages appear when shared on social platforms like Facebook and LinkedIn. Twitter Cards serve the same purpose for Twitter.

Define these in your page metadata and render them in your layout's section:

Structured Metadata

Metadata values are not limited to strings. You can use arrays, nested objects, and any YAML-supported data type. This makes metadata flexible enough to store structured information like tags, breadcrumbs, or feature flags that your templates can use for conditional rendering.