# Files

The files preset is intended for pages that only contain files and no additional content.

****

- Read more: <https://getkirby.com/docs/guide/blueprints/presets#available-presets__group-of-files-files>

****

<warning>
Do not use presets for new projects. Presets will be deprecated in future versions of Kirby.
</warning>

## Basic setup

A basic blueprint with a files preset creates an empty files upload section:

```yaml
Title: Files preset example
preset: files
```

### Empty
<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=2560&amp;height=1298&amp;enlarge=0"><img alt="" class="rounded" height="468" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=924&amp;height=468&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=462&amp;height=234&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=690&amp;height=350&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=924&amp;height=468&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=1380&amp;height=700&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/4b4a6e1ac7-1717846665/files-empty.png?width=1848&amp;height=937&amp;enlarge=0 1848w" width="924"></a></figure>

### Filled
<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=2560&amp;height=1298&amp;enlarge=0"><img alt="" class="rounded" height="468" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=924&amp;height=468&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=462&amp;height=234&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=690&amp;height=350&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=924&amp;height=468&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=1380&amp;height=700&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/presets/files/5a165cb0e7-1717846665/files-filled.png?width=1848&amp;height=937&amp;enlarge=0 1848w" width="924"></a></figure>

This basic blueprint can be extended in many ways.

## Options

### Label

```yaml
title: Gallery section
preset: files
label: Image gallery
```

### Template

You can set the `template` option to filter files and define the template that is assigned to each uploaded file.

```yaml
title: Gallery section
preset: files
template: image
```

### Layout

Like in any other files section, you can choose between `list` and `card` layout:

```yaml
title: Gallery section
preset: files
layout: cards
```

### Image

```yaml
title: Gallery section
preset: files
layout: cards
image:
  cover: true
  ratio: 1/1
  back: black
```

## Usage in tabs

<info>
All presets can also be used within tabs as the following example shows.
</info>

```yaml
title: Trip
icon: ✈

tabs:
  details:
    label: Details
    preset: page
    fields:
      intro:
        label: Intro
        type: textarea
  gallery:
    label: Gallery
    preset: files
```