File Field

The file field stores one managed file asset.

Best For

• downloadable PDFs
• brochures
• attachments
• specification sheets

Schema Example

{ "name": "downloadFile", "label": "Download File", "type": "file" }

Template Usage

<a href="{{ downloadFile.url }}">Download</a>

Download block example:

{{#if downloadFile}}
  <a href="{{ downloadFile.url }}" class="download-link">
    {{ downloadLabel | default("Download file") }}
  </a>
{{/if}}

Use It When

Use file when the section needs one downloadable or linked asset.

Do Not Use It When

Do not use file for:

• displayed images
• many files with row-specific metadata

Use image, images, or repeater instead.

Technical Notes

• use file for managed downloadable assets, not for visible image presentation
• pair the file field with a separate text field for the visible link label if needed
• guard optional download output with {{#if}}
• if each downloadable item needs its own title, description, or CTA, move to repeater

Related

• URL
• Image
• Repeater