Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Downloads

List downloadable brand assets with their configured format, size, and supporting notes.

<Downloads />

Usage

List the current brand’s configured downloads. Maintain file URLs and metadata in configuration; see Assets for preparing the files.

<Downloads />

Examples

List all configured downloads

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

<Downloads />

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.

<Downloads items={props.brand.downloads?.slice(0, 1) ?? []} />

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.

<Downloads items={[]} />

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

PropType
brand?BrandConfig

Override the resolved brand for this component. Supplied automatically in Brandtree MDX.

TypeBrandConfig
Defaultprops.brand
items?BrandDownload[]

Selected downloads, in order. Defaults to brand.downloads or an empty array.

TypeBrandDownload[]
class?string

Additional class on the outer element.

Typestring

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

Was this page helpful?