Front matter

The following example shows a front matter with all the required fields filled by placeholders:

You can copy the example above and replace all the placeholders with the appropriate values for your page.

The following table shows descriptions for all the required fields:

On the target page, which is the page where you want users to land, add the <path> of the original page to the front-matter as follows:

For example, you could find our FAQ page in the past under /help/faq. To help our users find the FAQ page, we moved the page one level up to /faq/ and changed the front matter as follows:

The change above allows any user to access the FAQ when they visit https://istio.io/faq/ or .

Optional front matter fields

However, Hugo supports many front matter fields and this page only covers those implemented on istio.io.

The following table shows the most commonly used optional fields:

Some front matter fields control the auto-generated table of contents (ToC). The following table shows the fields and explains how to use them:

Similarly, some front matter fields apply specifically to blog posts. The following table shows those fields: