Skip to content
Early access

Early access: 90% off your first 3 months on Solo and Team. Ends Nov 24, 2026. What’s includedDetails

Markdown forms

Collect autosaved answers in a document, with one row per person.

reference~8 minVerified v0.260.0

How answers work

Valid changes autosave to one row per identity. required="true" marks incomplete drafts; other valid answers still save. Invalid values show errors.

Autosave sends revision as If-Match. Stale saves return 409 response_changed; reload and retry. Everyone prefills with scope=own.

Needs

Connect an agent (superartifacts.app/mcp); decide privacy and retention.

Prompt

Make a feedback form
Publish a private autosaving form.

Field types

Fields need a bracket label and quoted name. Attributes: help, required, placeholder, pii (none/contact/sensitive/secret). Only listed attributes are accepted. Labels: 80 characters; help: 160; placeholder: 200. Names: snake_case, letter first, at most 40 characters. Separate choices with pipes.

DirectiveControl and limitAttributes
field-textText input; 500 charactersname, help, required, placeholder, pii, minLength, maxLength, pattern, identity
field-long_textTextarea; 20,000 charactersname, help, required, placeholder, pii, minLength, maxLength, rows
field-rich_textMarkdown textarea and preview; 20,000 charactersname, help, required, placeholder, pii, minLength, maxLength, rows
field-emailEmail input; valid emailname, help, required, placeholder, pii
field-urlURL input; HTTP(S)name, help, required, placeholder, pii
field-phoneTelephone input; 6–24 charactersname, help, required, placeholder, pii
field-colorPicker and hex input; #RGB or #RRGGBBname, help, required, placeholder, pii
field-integerNumber input; safe integername, help, required, placeholder, pii, min, max
field-decimalNumber input; precision 0–8name, help, required, placeholder, pii, min, max, step, precision
field-ratingRadio scale; 2–10, default 5name, help, required, placeholder, pii, scale
field-measurementAmount and fixed unit; known measure/unitname, help, required, placeholder, pii, measure, unit, min, max, step
field-booleanCheckbox; unanswered until chosenname, help, required, placeholder, pii
field-dateDate input; after/before boundsname, help, required, placeholder, pii, after, before
field-datetimeDate/time input; ISO instant with timezonename, help, required, placeholder, pii, after, before
field-timeTime input; HH:mm[:ss]name, help, required, placeholder, pii
field-choiceSelect; 2–48 choices, 80 characters eachname, help, required, placeholder, pii, choices
field-multi_choiceCheckboxes; up to 48 choicesname, help, required, placeholder, pii, choices, minChoices, maxChoices
field-jsonJSON textarea; 16,384 bytesname, help, required, placeholder, pii, maxBytes
field-imageUpload; 10 MiBname, help, required, placeholder, pii, accept, maxBytes
field-videoUpload; 100 MiBname, help, required, placeholder, pii, accept, maxBytes
field-fileUpload; 25 MiBname, help, required, placeholder, pii, accept, maxBytes
field-referenceEntry selector; published collection entryname, help, required, placeholder, pii, collection
field-reference_listMultiple entries; at most 100name, help, required, placeholder, pii, collection, minItems, maxItems

Examples

Each example is a separate document. Combined form sections must share one dataset.

Quick survey

markdown
:::form[Quick survey]{dataset="answers"}
::field-rating[How useful?]{name="useful" scale="5" required="true"}
________
::field-multi_choice[Topics]{name="topics" choices="Design|Engineering|Writing"}
________
:::

Registration

markdown
:::form[Registration]{dataset="registration"}
::field-text[Name]{name="name" identity="true" maxLength="120" pii="contact"}
________
::field-email[Email]{name="email" required="true"}
________
::field-file[Resume]{name="resume" accept="application/pdf" maxBytes="26214400"}
________
:::

Profile

markdown
:::form[Profile]{dataset="profile"}
::field-reference[Programme]{name="programme" collection="program"}
________
::field-measurement[Working weight]{name="weight" measure="load" unit="kg" min="0" step="0.5"}
________
::answers[Your saved profile]{fields="programme,weight"}
:::

Reference entries must exist and be published for visitor access; the agent confirms the authorized collection first. Forms derive those read grants, never CMS write access.

Privacy, identity and retention

TopicBehaviour
Identity“One person” means one platform identity. An anonymous artifact cookie lasts a year; clearing cookies or signing in after answering can create another row. Signed-in identity is stable across devices. Names and identity="true" label Who; they do not authenticate or deduplicate people.
Access and retentionDefaults: own-row reads, upsert, one row per identity, 30-day retention and 10,000 rows per artifact. Owners/Editors inspect responses in the dashboard artifact's Data tab; readers see only their own row. Contact data is masked for non-owners; sensitive values are encrypted; secrets stay write-only except audited owner reveal. Email, phone, media and free text above 280 characters are at least contact data. Only text/long_text can be secret, with finite retention at most 730 days. Media cannot be sealed. Ask the owner before collecting sensitive information or widening access.

Read responses

::answers[Your answers]{fields="programme,weight"} reads the current identity only. An owner response view uses ::data-table[Responses]{dataset="profile" fields="programme,weight" audience="owner"}. Owner scope is enforced.

Review my responses
Read owner-authorized answers without publishing them.

CSV exports decode choices, references and file links; JSON includes decoded values and stored values. Secrets remain hidden.

Offline and exports

TopicBehaviour
RecoveryWait for Saved before leaving. Offline changes stay in this tab's memory; reload or close can lose them. Retry after reconnecting. Upload bytes are never queued durably. If the row changed elsewhere, the form reloads your row and asks before overwriting the same field. No browser-unload save is guaranteed. Do not repeatedly retry invalid fields.
Exports and ListenListen reads labels and help, excluding answers. Tiles make no data calls. Print, PDF and Word show blank forms; saved answers are never included.

References must point to published entries in their declared collection. Missing, draft and foreign entries are refused.

Limits and changes

TopicBehaviour
LimitsAt most 24 fields, four reference collections, 6,144 policy bytes and 128 KiB per response. Fields share the aggregate ceiling. Forms cannot nest; directives allow four levels and 65,536 bytes each. All attribute values are quoted. Fenced examples do not become forms. Duplicate names and conflicting datasets fail publication. Removed fields stay in historical data; removing a form does not delete responses. Use a new name for a changed type or reference collection; choices may grow. New forms default to 30-day retention; republishing preserves your stored privacy, retention and row limits.
UnavailableNo conditional fields, public response tables, durable offline drafts, cross-identity merging or multiple datasets.

Check it worked

Data lists saved answers; Details opens each row; Last answered shows its latest update. Choices use chips, ratings use stars, measurements show units. Expand long answers/JSON. Removed fields stay marked. Two identities should show two rows.

Invalid source is saved with a warning. Correct and save to activate it.