Configure the Select Field

This article explains what the Select field is and how to configure it in the Custom Type builder.


The Select field allows content writers to pick among a number of options from a dropdown menu.

Screenshot of the Select field in the drag-and-drop editor.

The visual builder

When configuring a Select field you'll see the options to set the Field name, API ID, and Field placeholder.

Add one option per line. The options will appear in the order you enter them.

Screenshot of the Select field editor.

JSON model

The following table displays the JSON configuration options available in the JSON editor.

type

string (required)

Value must be Select

config

object

Object for the configuration options

config.label

string

The label that shows up for the field in the document editor

config.placeholder

string

A user-friendly placeholder for the field in the entry editor

config.options

array

An array of strings that will be the available options in the select dropdown

config.default_value

string

If it's set to the be first value in the options, the select will default to this option

Example JSON configuration

The following JSON defines a Select field which defaults to the first option:

Copy
"example_select" : {
  "type" : "Select",
  "config" : {
    "options" : [ "Yes", "No" ],
    "default_value": "No",
    "label" : "Is this a Featured Post?"
  }
}

API response example

Here is an API response of a Select field with the API ID of example_select:

Copy
// API response example of a Select field

{
  //...
  "example_select": "My selected Value"
}

Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Get in touch with us on our Community Forum.