Number inputs

A Number input lets your team members store numerical information in your data files or the front matter of markup files.

There are two types of Number input:

• Number
• Range

For each input, you can configure the minimum and maximum permitted value, the step value for increasing or decreasing the value, and how CloudCannon handles empty values.

You can also use the general configuration options available for all inputs.

Number#

The Number input provides an editing interface for numerical data.

You can configure a Number input using the type key with the value number. Define the type key under your input key name within _inputs. For more information, please read our documentation on configuring your inputs.

_inputs:
  series:
    type: number

{
  "_inputs": {
    "series": {
      "type": "number"
    }
  }
}

Once configured, the Number input will appear in the Data Editor or sidebar of the Visual or Content Editor when you add it to a data file or the front matter of a markup file.

---
series: 5
---

Content goes here.

Range#

The Range input provides an editing interface for numerical data, using a sliding scale to adjust a number within a defined range.

You can configure a Range input using the type key with the value range. Define the type key under your input key name within _inputs. You must also define the min, max, and step options for this input to function.

For more information, please read our documentation on configuring your inputs.

_inputs:
  priority:
    type: range
    options:
      min: 1
      max: 5
      step: 1

{
  "_inputs": {
    "priority": {
      "type": "range",
      "options": {
        "min": 1,
        "max": 5,
        "step": 1
      }
    }
  }
}

Once configured, the Range input will appear in the Data Editor or sidebar of the Visual or Content Editor when you add it to a data file or the front matter of a markup file.

---
priority: 4
---

Content goes here.

Options#

You can configure Number inputs using the options key under your input key, inside of _inputs.

_inputs:
  background:
    type: number
    options:
      min: 0
      max: 10
      step: 2
      empty_type: 

{
  "_inputs": {
    "background": {
      "type": "number",
      "options": {
        "min": 0,
        "max": 10,
        "step": 2,
        "empty_type": null
      }
    }
  }
}

Number inputs have the following options available:

Unconfigured Number inputs#

In some cases, CloudCannon can still detect a Number input even if you have not configured it.

CloudCannon will interpret any unconfigured input with the key name number, or that ends in _number, as a Number input. Additionally, CloudCannon will interpret any unconfigured input with a numerical value as a Number input.

CloudCannon cannot detect unconfigured Range inputs as the min, max, and step options are required for this input to function.

page_number: 7
days: 50

This behavior is convenient if you have simple inputs or do not want to configure inputs. It is also beneficial for new websites on CloudCannon where you have yet to create any CloudCannon-specific configuration.

Valid values#

Here are some examples of valid values for the key number. These work for both Number and Range inputs.