# Document

An artifact for static documents

Canonical URL: https://docs.paradoc.dev/schemas/artifacts/document/

A Document is a static document. It is the simplest artifact in Paradoc.

Documents are used for disclosures, pamphlets, statutory notices, or any other static content.

## Properties

| Name | Type | Description |
| --- | --- | --- |
| `$schema?` | `string` | Current dated schema URL. Required in artifact files and optional for in-memory objects |
| `kind` | `"document"` | Literal "document" discriminator |
| `name` | `string` | Unique identifier; must follow slug constraints |
| `version?` | `string` | Artifact version (semantic versioning) |
| `title?` | `string` | Human-friendly name presented to end users |
| `description?` | `string` | Long-form description or context |
| `code?` | `string` | The form number as printed by its issuer (e.g. W-9, ACORD 25), or a self-issued form's own number |
| `language?` | `string` | BCP 47-style source language tag. Defaults to en when omitted |
| `issuer?` | `string` | Organization that issues the form (e.g. U.S. Internal Revenue Service) |
| `edition?` | `Edition` | The issuer's edition this artifact encodes, for artifacts the issuer reissues. Every edition of one artifact shares the same name and has its own version line |
| `metadata?` | `Metadata` | Custom metadata map (keys must be alphanumeric with hyphens) |
| `instructions?` | `ContentRef` | Domain or compliance reference content (e.g., regulatory guidance) |
| `agentInstructions?` | `ContentRef` | LLM/agent prompts for presentation guidance |
| `layers?` | `Record<string, Layer>` | Named layers for rendering this document into different formats |
| `defaultLayer?` | `string` | Key of the default layer to use when none specified |

## Examples



**YAML**

```yaml
$schema: https://schema.paradoc.dev/2026-10-02.json
kind: document
name: lead-paint-disclosure
version: "1.0.0"
title: Lead Paint Disclosure
description: Required disclosure for properties built before 1978

layers:
  pdf:
    kind: file
    mimeType: application/pdf
    path: /disclosures/lead-paint.pdf
    title: PDF Version

  markdown:
    kind: inline
    mimeType: text/markdown
    text: |
      # Lead Paint Disclosure

      This property was built before 1978 and may contain lead-based paint.

      # Important Information

      Lead from paint, paint chips, and dust can pose health hazards...

defaultLayer: pdf
```

**JSON**

```json
{
  "$schema": "https://schema.paradoc.dev/2026-10-02.json",
  "kind": "document",
  "name": "lead-paint-disclosure",
  "version": "1.0.0",
  "title": "Lead Paint Disclosure",
  "description": "Required disclosure for properties built before 1978",
  "code": "EPA-747-K-12-001",
  "metadata": {
    "agency": "EPA/HUD"
  },
  "layers": {
    "pdf": {
      "kind": "file",
      "mimeType": "application/pdf",
      "path": "/disclosures/lead-paint.pdf",
      "title": "Lead Paint Disclosure"
    },
    "markdown": {
      "kind": "file",
      "mimeType": "text/markdown",
      "path": "/disclosures/lead-paint.md",
      "title": "Lead Paint Disclosure"
    }
  },
  "defaultLayer": "pdf"
}
```

## Related

* [Layer](/schemas/artifacts/shared/layer) - Layer specification details