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 · Media

File

A download card for an uploaded file: name, type, and size. file is the id from files_finalize; label replaces the shown name.

ExamplesLink to this section

A download card
q3-board-report.pdfPDF · 2.4 MBDownloadBoard deck, Q3PDF · 2.4 MBDownload
Show JSONHide JSON
{
  "version": 1,
  "root": "stack",
  "elements": {
    "stack": {
      "type": "Stack",
      "props": { "gap": "sm" },
      "children": ["report", "labelled"]
    },
    "report": {
      "type": "File",
      "props": { "file": "1f6b2a40-93c4-4c8e-b1d2-5e7a9c0f3b21" }
    },
    "labelled": {
      "type": "File",
      "props": {
        "file": "1f6b2a40-93c4-4c8e-b1d2-5e7a9c0f3b21",
        "label": "Board deck, Q3"
      }
    }
  }
}

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
filerequiredstring (uuid)—
labelstringmax 200 chars

RulesLink to this section

  • Upload with files_request_upload, PUT the bytes, then files_finalize. Put the returned id in file.
  • label replaces the shown file name.

Children and eventsLink to this section

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

It emits no events.

Edit this page on GitHub
PreviousImageNextPlaceholder

On this page

  • Examples
  • Props
  • Rules
  • Children and events