Skip to content

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" }
]