FAQ
Developer hub
Plugin Input Fields
Hidden Fields

Hidden Fields

The Hidden Field feature lets you control which fields appear in the UI based on user selections. It’s perfect for creating clean, dynamic forms where users only see what’s relevant.

This is especially useful when you want to show or hide specific fields based on another field’s value—like a dropdown selection.


Why Use Hidden Fields?

  • Hide irrelevant fields to reduce clutter

  • Show only the fields needed for a specific selection

  • Pass hidden data silently without user input

  • Maintain flexible form logic with minimal user confusion


Important Notes

  • Hidden fields do not support dynamic API calls for children

  • You can use them with static dropdown options

  • Fields are controlled using the "fieldsToHide" logic


Example Scenario

Let’s say you have a dropdown called File Type with options:

  • Image

  • PDF

  • Text

Sample JSON Setup

[
  {
    "key": "FileType",
    "type": "hidefields",
    "label": "File Type",
    "options": [
      { "label": "attachment", "value": "attachment", "sample": "attachment" },
      { "label": "image", "value": "image", "sample": "image" },
      { "label": "file", "value": "file", "sample": "file" }
    ],
    "fieldsToHide": {
      "file": ["image", "attachment"],
      "image": ["attachment", "file"],
      "attachment": ["image", "file"]
    }
  },
  {
    "key": "image",
    "type": "string",
    "label": "Image URL"
  },
  {
    "key": "file",
    "type": "string",
    "label": "File Path"
  },
  {
    "key": "attachment",
    "type": "string",
    "label": "Attachment Link"
  }
]

🔍 How It Works

  • User selects "image" in the dropdown
    → Only the image field is shown.

  • If "file" is selected
    → Only the file field is shown.

  • If nothing is selected
    → All fields are visible by default


💡 Pro Tips

  • Use this pattern to conditionally reveal config sections, upload fields, or advanced settings

  • Works best when paired with "type": "hidefields" and clearly defined fieldsToHide

  • Helpful in actions like file uploads, media classification, or multi-mode plugins


Show fields based on selected field:

image


image


image