🇩🇪 Deutsch 🇺🇸 English 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇳🇱 Nederlands 🇵🇹 Português
🇩🇪 Deutsch 🇺🇸 English 🇪🇸 Español 🇫🇷 Français 🇮🇹 Italiano 🇳🇱 Nederlands 🇵🇹 Português

Component Field Reference

Component Field Reference

This reference covers the field types available when defining FaceFlow Components.

Use this section when you need to decide what kind of editor-facing input a section should expose and how that input should be rendered safely and predictably.

Top-Level Field Types

Repeater-Only Subfield Types

These field types are intended for use inside repeater rows rather than as general top-level section fields.

Field Selection Rules

Choose a field type by the content contract you want to preserve:

  • use text for short strings
  • use textarea for plain multi-line copy
  • use number for numeric values that should stay numeric
  • use url for links and destinations
  • use date for publish, event, or timeline dates
  • use image or images for managed media
  • use file for downloadable assets
  • use select or checkbox for controlled options
  • use richtext for editorial formatting
  • use htmlcode only for controlled advanced markup
  • use map for structured location data
  • use repeater for structured repeated rows
  • use formSelect and reviewSelect for managed embeds

Quick Decision Guide

one short string            -> text
one multi-line plain block  -> textarea
formatted editorial content -> richtext
repeatable cards or FAQs    -> repeater
embed a managed Form        -> formSelect
embed a managed Review      -> reviewSelect
advanced custom markup      -> htmlcode

Schema Example

[
  { "name": "title", "label": "Title", "type": "text" },
  { "name": "summary", "label": "Summary", "type": "textarea" },
  { "name": "heroImage", "label": "Hero Image", "type": "image" },
  { "name": "ctaUrl", "label": "CTA URL", "type": "url" }
]