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

Select

A dropdown of text options. Bind value with { "$bindState": "/path" }. Takes description, error, hideLabel, disabled, and fullWidth like Input.

ExamplesLink to this section

Bound to state
Environment

Deploying to Preview.

Show JSONHide JSON
{
  "version": 1,
  "root": "page",
  "elements": {
    "page": {
      "type": "Stack",
      "props": { "gap": "sm" },
      "children": ["env", "chosen"]
    },
    "env": {
      "type": "Select",
      "props": {
        "label": "Environment",
        "options": ["Production", "Preview", "Development"],
        "value": { "$bindState": "/env" }
      }
    },
    "chosen": {
      "type": "Text",
      "props": {
        "size": "sm",
        "tone": "muted",
        "text": { "$template": "Deploying to ${/env}." }
      }
    }
  },
  "state": { "env": "Preview" }
}

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
optionsrequiredstring[]1–100 items
valuestringmax 120 chars
placeholderstringmax 80 chars
fullWidthboolean—
descriptionstringmax 400 chars
errorstringmax 300 chars
hideLabelboolean—
disabledboolean—

RulesLink to this section

  • Inputs change only the spec's own state, on the reader's page. Nothing is saved or sent.
  • description sits under the label. error marks the field invalid and shows the message. hideLabel keeps the label for screen readers only.
  • A Select is at most 384 pixels wide; fullWidth lets it fill its container, like Input and Textarea.

Children and eventsLink to this section

Select 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
PreviousCheckboxNextSwitch

On this page

  • Examples
  • Props
  • Rules
  • Children and events