Browse all documentation

Textarea field

Store multi-line plain text as a string.

Use field.Textarea for multi-line plain text such as a synopsis, internal note, or address. It stores a string—the line breaks are part of that string—and renders a larger text control in the admin.

In the admin

A populated Summary textarea in the Ridu admin showing a focused multi-line plain-text control.

Line breaks remain part of one string; the control does not create rich-text structure.

Smallest working example

content/posts.go
field.Textarea("summary", field.MaxLength(280))

Create and update inputs accept summary: string; optional fields may be omitted. Reads return the same plain string through REST, the Local API, and the generated SDK.

A realistic configuration

content/reviews.go
field.Textarea(
  "editorNote",
  field.Required(),
  field.MinLength(10),
  field.MaxLength(2_000),
  field.Placeholder("Explain what must change before publication…"),
  field.Sidebar(),
)

Textarea fields accept the common string options: Required, MinLength, MaxLength, Default, Localized, Unique, Index, and the shared admin options. Use uniqueness only for a genuine invariant; long prose is rarely an appropriate indexed or unique key.

Localization stores an independent string per content locale. Admin-language translations for the label, description, or placeholder are separate and do not localize content.

Constraints and querying

String filters work as they do for Text, including equality, containment, like, selection, and sorting. Long text queries are not relevance-ranked search. Build a search index outside this field when your application needs stemming, ranking, or language analysis.

Textarea does not parse Markdown or HTML and does not sanitize it for rendering. Escape plain text in your frontend. If authors need formatting, links, uploads, or structured blocks, use the Rich-text plugin or Blocks.

Common mistakes

  • Do not store an object or arbitrary array in a textarea; use JSON or model the shape with fields.
  • MaxLength limits characters accepted by Ridu; it does not visually truncate the control.
  • Hiding a note in the admin is not a field access rule.

See field.Textarea and access control.