Insites Docs Developers guide Pages and LayoutsContent and LayoutsMetadata

Metadata

Last updated on June 26, 2024.

Metadata is information that describes a set of data. It provides additional context about a page, enabling search engines and other services to find or use your page. Used properly, metadata can help your page rank higher in the search results, and provide additional context to your page users, among other useful benefits.

Metadata is implemented on Insites by extending a page using . Key-value pairs are then used for the actual metadata as in the example below:

Important

The easiest way to add, edit, or delete metadata on a page on Insites is via the Instance Admin. A summary of the steps to make changes to or create new metadata on a page are as follows:


  1. Select CMS on the main menu.
  2. Click on Content.
  3. You may choose to add a page or edit an existing one. Press ADD CONTENT to add a page or select a page from the list and click on its Edit row action link.
  4. Go to the Metadata tab on the form for editing or creating a page and make your changes to or create new metadata.

Visit our documentation on Adding Content for a complete guide in adding or editing metadata on a page on Insites.

The primary objective of this guide is to showcase how metadata is used via code.

Displaying metadata on the page

Metadata is available through Liquid as :

Searching for a page using its metadata

You can search for a page using its metadata in GraphQL queries (all support and pagination arguments). Here's an example of a GraphQL query with all possible parameters:

Here are some examples of using the above query from a Liquid template to find metadata:

Find pages with the word 'TITLE' somewhere in the metadata (in keys or values)

Find pages without the word 'TITLE' in the metadata (in keys or values)

Match pages having top-level key 'tags'

Match pages without the 'tags' key

Match pages with the 'tags' key, having (or including) the value 'bar'

Match pages that do not have the 'tags' key equal (or including) to the value 'bar'

Related topics

Pages

Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.