Kit Developer Documentation

{ "type": "group", "name": "filter_group", "settings": [ { "type": "dynamicSelect", "label": "Folders", "name": "folder", "request_url": "https://example-plugin.com/folders", "required": false } ] }

Fields cannot be dependent on dynamic select inputs as they are only available for the media source, that has restricted component functionality. Check the media source documentation for more details.

Plugin type	Availability	Additional notes
Content blocks
Media source		Available as part of the preset `filter` group functionality. Check media source documentation for more details.

Plugin type

Availability

Additional notes

Content blocks

Media source

Available as part of the preset filter group functionality. Check media source documentation for more details.

Request URL behaviour

Kit makes POST requests to your request_url in the following scenarios:

Initial load: Request to populate the dropdown options when the plugin loads

Filter selection: Request with the selected value to return filtered media results

Your endpoint should return an array of label-value pairs for the dropdown options:

{
  "options": [
    {
      "label": "Home",
      "value": "home"
    },
    {
      "label": "Favorites", 
      "value": "favorites"
    },
    {
      "label": "Shared",
      "value": "shared"
    }
  ]
}

Properties

string

required

dynamicSelect - the type of the component

string

required

A unique internal-only identifier that is posted to an app’s plugin server to share values inputted by the creator

string

required

Creator-facing identifier that is shown in the plugin environment

string

required

The endpoint URL that Kit will call to fetch dynamic options and handle filter selections

boolean

Determines whether the creator must make a selection before proceeding

  {
    "type": "group",
    "name": "filter_group",
    "settings": [
      {
        "type": "dynamicSelect",
        "label": "Folders",
        "name": "folder",
        "request_url": "https://example-plugin.com/folders",
        "required": false
      }
    ]
  }

  {
    "settings": {
      "folder": "favorites"
      // ...additional plugin settings
    }
    // ...plugin-specific additional data
  }

Getting started

Building plugins

Dynamic select input

Compatibility

Request URL behaviour

Properties

​Compatibility

​Request URL behaviour

​Properties

Compatibility

Request URL behaviour

Properties