---
title: Downloads
description: List downloadable brand assets with their configured format, size, and supporting notes.
sidebar:
  order: 27
---

import previewCode from "../../snippets/downloads.mdx?raw";
import example0 from "../../snippets/downloads-selected.mdx?raw";

import emptyCode from "../../snippets/downloads-empty.mdx?raw";

<ComponentPreview path="downloads" code={previewCode} />

## Usage

List the current brand’s configured downloads. Maintain file URLs and
metadata in configuration; see [Assets](/assets) for preparing the files.

```mdx
<Downloads />
```

## Examples

### List all configured downloads

Omit `items` to use every entry in `brand.downloads`, including configured
format, size, and note metadata.

<ComponentPreview path="downloads" code={previewCode} />

### Show a subset of assets

Pass selected entries through `items` to limit the list for one section. This
example shows only the first configured download.

<ComponentPreview path="downloads-selected" code={example0} />

### Hide downloads for a section

Pass an empty array to override the configured list. This preview intentionally
has no rendered links; the component does not add an empty-state message.

<ComponentPreview path="downloads-empty" code={emptyCode} />

## Selection and empty states

Omitting `items` uses `brand.downloads`. Passing an empty array renders nothing,
as does a brand without downloads.

Provided entries are matched against the current brand by `id`. A matching
configured entry replaces the supplied object, preserving its localized label
and note. The implementation also falls back to matching `href` for an item
without an ID, although the typed `BrandDownload` contract requires an `id`.
Use configured entries when selecting assets.

The component renders links with the `download` attribute. It does not create
archives or collect assets, so each configured URL must point to a real file.

## API reference

| Prop | Type | Default | Description |
| - | - | - | - |
| `brand?` | `BrandConfig` | `props.brand` | Override the resolved brand for this component. Supplied automatically in Brandtree MDX. |
| `items?` | `BrandDownload[]` | - | Selected downloads, in order. Defaults to brand.downloads or an empty array. |
| `class?` | `string` | - | Additional class on the outer element. |

Each `BrandDownload` requires `id`, `label`, and `href`; `format`, `size`, and
`note` are optional strings. No content slot is rendered.