# Document Download block: one document as a button, link or card

*Collection: Displaying Libraries · Category: Display · Availability: FileDeck Free · Canonical URL: https://www.getfiledeck.com/docs/download-block/*

Sometimes you don't want a whole library, just one file: the latest annual report
on the home page, a booking form in a blog post, the safety data sheet beside a
product. The **Document Download** block puts one document anywhere, as a download
button, a text link, or a small card showing its title, file type and size.

> **Free** — included in every FileDeck install.

## Add it

1. In the block editor, add the **Document Download** block.
2. Under **Choose a document**, type part of the document's title and pick it.
3. Choose how it shows: **Button**, **Card with file type and size**, or **Text link**.
4. Optionally change the button text (it says "Download" to begin with).

The download goes through FileDeck like any library download, so it is counted,
and your access rules, download limits and any download checks you've set up all
apply.

## The shortcode

Classic themes and page builders use the shortcode:

```
[filedeck_download id="123"]
[filedeck_download id="123" style="card"]
[filedeck_download id="123" style="text" text="Get the form"]
```

| Attribute | Values | Default | What it does |
|---|---|---|---|
| `id` | A document ID | — | The document to offer. |
| `style` | `button`, `card`, `text` | `button` | A button, a card with the file type and size, or a plain text link. |
| `text` | Any text | `Download` | The button or link text. |

## Who sees what

A visitor who can open the document gets the button, link or card. A visitor who
can't, because the document is restricted, sees a padlock in its place, exactly as
in a library, and the card doesn't show a restricted document's title to them.

## FAQ

### Can it show the document itself instead of a download button?

Use the [Document Embed block](https://www.getfiledeck.com/docs/inline-document-embed/) for that: it shows a
PDF, an image or a linked Google file inline, with an optional download link
under it.

### Is this a Pro feature?

No. The block and the shortcode are in the free plugin. See
[free vs Pro](https://www.getfiledeck.com/docs/free-vs-pro/).
