These inputs are for editing plain text in your data.
Text#
Single line input for short text values.
Text inputs are shown for inputs configured with the type text
, or for inputs not matching any other naming convention.

tagline: Hand-crafted clothing.
{
"tagline": "Hand-crafted clothing."
}
tagline = "Hand-crafted clothing."
footer_message: Look up!
_inputs:
footer_message:
type: text
{
"footer_message": "Look up!",
"_inputs": {
"footer_message": {
"type": "text"
}
}
}
footer_message = "Look up!"
[_inputs.footer_message]
type = "text"
Textarea#
Expanded text input for longer and/or multi-line text.
Textarea inputs are shown for inputs configured with the type textarea
, or for input keys matching:
textarea
*_textarea
description
*_description

description: >-
Products are crafted in-house by hand, making each piece a labor of love and
an exercise in craftsmanship.
{
"description": "Products are crafted in-house by hand, making each piece a labor of love and an exercise in craftsmanship."
}
description = "Products are crafted in-house by hand, making each piece a labor of love and an exercise in craftsmanship."
footer_copy: |-
We hope you love our products.
We are proud of them!
_inputs:
footer_copy:
type: textarea
{
"footer_copy": "We hope you love our products.\nWe are proud of them!",
"_inputs": {
"footer_copy": {
"type": "textarea"
}
}
}
footer_copy = """
We hope you love our products.
We are proud of them!"""
[_inputs.footer_copy]
type = "textarea"
Email#
Single line input for email addresses.
Email inputs are shown for inputs configured with the type email
, or for input keys matching:
email
*_email
email_address
*_email_address

email: support@cloudcannon.com
email_address: support@cloudcannon.com
{
"email": "support@cloudcannon.com",
"email_address": "support@cloudcannon.com"
}
email = "support@cloudcannon.com"
email_address = "support@cloudcannon.com"
to: support@cloudcannon.com
_inputs:
to:
type: email
{
"to": "support@cloudcannon.com",
"_inputs": {
"to": {
"type": "email"
}
}
}
to = "support@cloudcannon.com"
[_inputs.to]
type = "email"
Disabled#
Single line input that cannot be edited for any value.
Disabled inputs are shown for inputs configured with an unknown type
, or for inputs with values that cannot be edited with the configured type
.
Text is stored unquoted if possible. Unquoted text containing only numbers with commas may require a workaround in Jekyll.
Options#
Text inputs have the following available options:
Set how an ‘empty’ value will be saved. Does not apply to existing empty values. Can be one of the following:
string
- an empty value for this input will be stored as""
.null
- an empty value for this input will be stored as a null value (default). This does not apply to TOML files.
Valid values#
Documented below are the valid formats for text, textarea, and email inputs.
The lists of examples are non-exhaustive.
Empty/null value:
text:
Any valid string (quoted or unquoted):
text: ""
text: ''
text: any string
text: "any string"
text: 'any string'
Any valid multiline string:
-
text: >
multiline string -
text: >-
multiline string -
text: >+
multiline string -
text: |
multiline string -
text: |-
multiline string -
text: |+
multiline string
Any valid string:
text = ""
text = "any string"
Any valid escaped string:
text = ''
text = 'any string (literal)'
Any valid multiline string:
-
text = """
multiline string""" -
text = """\
multiline string (trimmed) \
""" -
text = '''
literal multiline string'''
Null value:
"text": null
Any valid string:
"text": ""
"text": "any string"
Any valid multiline string:
"text": "multiline \n string"