Open navClose nav

Fields

Text

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/text-preview.png

Single line text input. Displayed for Front Matter values that are short strings. For example, a page title.

---
title: "My New Page Title!"
---

See detailed documentation


Textarea

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/textarea-preview.png

Multi-line text input. Displayed for Front Matter values that are long strings. For example, a page description.

---
description: "Write an awesome description for your new site here. It will appear in your document head meta (for Google search results) and in your RSS feed's site description."
---

See detailed documentation


Number

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/number-preview.png

A stepped number input. Displayed for Front Matter values that are integers. For example, page weight.

---
weight: 1
number: 3.14
---

See detailed documentation


Toggle

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/toggle-preview.png

True or false toggle. Displayed for Front Matter values that are booleans. For example, a feature toggle.

---
show_feature: true
---

See detailed documentation


Select

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/select-preview.png

Multiple options displayed in a dropdown. Can be used for Front Matter values that are strings, but should be restricted to a set of options. Options can be sourced from existing content, data files, or manually provided. For example, a page’s author.

---
author: "scott-gallant"
---

See detailed documentation


Datetime

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/datetime-preview.png

Date and time picker. Used for Front Matter values that are valid date strings. Can be restricted to only date or time values. For example, page created date or page publish date.

---
date: 2017-12-31T12:00:00+00:00
publish_date: 2018-01-07T12:00:00+00:00
---

See detailed documentation


Color Picker

Color Picker field UI

A color picker. Useful for Front Matter values that are used to render color. Can be saved as RGB or hex value.

See detailed documentation


Tags Field

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/tags-preview.png

A list of options displayed as tags. Used for Front Matter values that are an array of strings. For example, page tags.

---
tags:
    - hugo
    - jekyll
    - static-site-generators
---

See detailed documentation


Sortable List Field

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/sortable-list-preview.png

A list of options displayed in a list. Used for Front Matter values that are an array of strings. Can be configured to restrict options in a dropdown. For example, page authors or related pages.

---
authors:
    - "scott-gallant:
    - "jordan-patterson"
---

See detailed documentation


File Upload

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/file-preview.png

File upload input that adds uploads to the Media Library. Used for Front Matter values that are a string ending with a file extension. For example, a featured image.

---
banner: "/uploads/2017/12/31/banner_image.jpg"
extra_style: "/css/extra_styles.css"
extra_script: "/js/extra_script.js"
---

See detailed documentation


Multi-File Upload

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/multi-file-preview.png

Gallery of media files. Used for Front Matter values that are an array of strings ending with a file extension. For example, an image carousel.

---
carousel: 
    - "/uploads/2017/12/31/mountains.jpg"
    - "/uploads/2017/12/31/field.jpg"
    - "/uploads/2017/12/31/cabin.jpg"

extra_styles: 
    - "/css/extra_styles.css"

extra_scripts: 
    - "/js/extra_script.js"
---

See detailed documentation


Field Group

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/field-group-preview.png

Group of Front Matter Fields. Used for Front Matter values that are an object. For example, your site’s footer information.

---
footer:
    copyright: "© 2017 Acme Inc."
    privacy_policy: "/privacy.md"
    terms_of_service: "/terms.md"
---

See detailed documentation


Repeatable Field Group

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/repeatable-field-group-preview.png

List of Field Groups. Used for Front Matter values that are an array of like-objects. For example, a list of authors.

---
authors:
    - name: Scott Gallant
      bio: CEO & Co-founder
      identifier: scott-gallant
    - name: Jordan Patterson
      bio: CTO & Co-founder
      identifier: jordan-patterson
---

See detailed documentation

Include Template

Include the fields of another Front Matter Template into the current one. Good for commonly-reused front matter fields like SEO information.

See detailed documentation

Blocks

A Blocks field is similar to a Repeatable Field Group, except that it supports unlike objects. Blocks fields are great for things like dynamic page layouts: a series of sections where each section may consist of different fields.

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/04/blocks-content-ui.png

Blocks fields work by including other front matter templates. You specify which templates can be used in your blocks field when creating the Front Matter Template. When adding content to a Blocks field, you can select which of these templates to add from a dropdown.

+++
[[blocks]]
background_style = "Brand Color"
heading = "Features"
size = "Small"
template = "hero-section"
[[blocks]]
background_style = "Light"
content = "[Bulma](https://bulma.io/) is a modern, responsive CSS framework with a flexbox-based grid system. "
heading = "Built With Bulma"
image = "/uploads/2018/04/19/bulma-logo.png"
image_position = "Left"
template = "media-feature"
+++

See detailed documentation


Last updated on April 23, 2017