artifacts.space/Docs
Sign in

Get started

  • Introduction
  • Quickstart
  • Client setup

Reference

  • MCP reference
  • Formats
  • Themes

Work together

  • Sharing, teams, and agents

Run it

  • Limits and quotas
  • Self-hosting

Earlier formats

  • JSON Render
  • Components

    Layout

    • Section
    • Stack
    • Grid
    • Card
    • Tabs
    • Accordion
    • Separator
    • Box

    Content

    • Heading
    • Text
    • Markdown
    • Code
    • Callout
    • Badge
    • List
    • Steps
    • Link
    • Quote
    • Icon
    • Avatar
    • AvatarGroup
    • Kbd
    • Rating

    Data

    • Table
    • Metric
    • Chart
    • KeyValue
    • Progress
    • Timeline
    • Diagram

    Planning

    • Board
    • Calendar

    Inputs

    • Checklist
    • Checkbox
    • Select
    • Switch
    • Slider
    • Button
    • Input
    • Textarea

    Media

    • Image
    • File
    • Placeholder
  • Dynamic props and actions
  • Charts
  • Section templates
  • Validation
  • Stout guarantees
  • Playground
  • Prompting your agent
artifacts.space
DocsSourceSign inCreate accountSupportPrivacyTerms

© 2026 Webrenew LLC

Components · Inputs

Textarea

A multi-line text field. rows (2-12, default 3) is the least number of lines it shows; it grows with what is typed. Bind value with { "$bindState": "/path" }; it only changes on-page state and nothing is ever sent. Takes description, error, hideLabel, disabled, and fullWidth like Input.

ExamplesLink to this section

A feedback box

No notes yet.

Show JSONHide JSON
{
  "version": 1,
  "root": "page",
  "elements": {
    "page": {
      "type": "Box",
      "props": { "gap": "sm", "maxWidth": "md" },
      "children": ["notes", "count"]
    },
    "notes": {
      "type": "Textarea",
      "props": {
        "label": "Notes for the reviewer",
        "placeholder": "What should they look at first?",
        "rows": 4,
        "value": { "$bindState": "/notes" },
        "fullWidth": true
      }
    },
    "count": {
      "type": "Text",
      "props": {
        "tone": "muted",
        "size": "sm",
        "text": {
          "$cond": { "$state": "/notes" },
          "$then": "Notes are on this page only.",
          "$else": "No notes yet."
        }
      }
    }
  },
  "state": { "notes": "" }
}

PropsLink to this section

Generated from the zod schema the server validates with. Unknown props are ignored with a warning. Any prop can also be a dynamic value such as { "$state": "/path" }; it is checked again once it resolves.

PropTypeLimits and defaults
labelrequiredstringmax 120 chars
placeholderstringmax 120 chars
valuestringmax 5,000 chars
rowsinteger2–12
fullWidthboolean—
descriptionstringmax 400 chars
errorstringmax 300 chars
hideLabelboolean—
disabledboolean—

RulesLink to this section

  • What a reader types changes only the spec's own state, on the reader's page. Nothing is saved or sent.
  • rows is 2 to 12 and defaults to 3. It is the least number of lines the field shows; the field grows with what is typed.
  • In a spec with a bound Input or Textarea, a Link address and Markdown, Steps, and Diagram text must be written in the spec, so typed text can never reach a link.

Children and eventsLink to this section

Textarea is a leaf: it does not show children. Validation warns when a leaf has some; wrap them in a Stack or Card instead.

Events: change. Bind one with on to run a state action; see Actions.

Edit this page on GitHub
PreviousInputNextImage

On this page

  • Examples
  • Props
  • Rules
  • Children and events