upload
Set files on a labeled file input
Upload a file to a labeled <input type="file">. The first quoted value is a filename resolved beside the .stk file.
Syntax
When I upload "<filename>" to "<field>"Qualifiers
| Qualifier | Role | Example |
|---|---|---|
to | File input label | upload "invoice.pdf" to "Attachments" |
Requirements
| Item | Contract |
|---|---|
| Element / control shape | Native <input type="file"> (may be hidden). Label may bind via id, data-testid, aria-label, name, or associated <label> text |
| How the label binds | file id → data-testid → aria-label → name → label ≫ file input |
| Qualifiers that change resolve | to = field label; first quote is filename (resolved beside .stk) |
| Platform | Web; multi-file comma list is web-only and needs multiple on the input |
| Wrong shape → use instead | Custom dropzone without a file input → not supported for upload |
When it fails
- Not found — no file input for that label.
- File path — basename missing beside
.stk/files/.
See also UI contracts.
Examples
When I upload "invoice.pdf" to "Attachments"File lookup
{stk-dir}/filename{stk-dir}/files/filename
Filename only — no paths and no $ENV in the filename string.