# Shortcodes in articles

With shortcodes you place downloads in articles, modules and every other text that runs through the content plugins. The easiest way is the button **Download** in the editor (see *Editor button*); you can also write them by hand.

<figure id="bkmrk-an-article-with-ever"> ![An article with link, button, counter and list from shortcodes and the module](https://docs.graup-it.de/uploads/images/gallery/2026-11/dHbdoku-17-website-beitrag.png) <figcaption>An article with every kind of shortcode and, below, the module.</figcaption></figure>## The forms

<table class="table" id="bkmrk-shortcoderesult-%7Bfil"> <thead> <tr><th scope="col">Shortcode</th><th scope="col">Result</th></tr> </thead> <tbody> <tr><td><code>&#123;fileshelf id&#61;12&#125;</code></td><td>Link with the title of the download</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 text&#61;&#34;Get the form&#34;&#125;</code></td><td>Link with your own text</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 button&#125;</code></td><td>Button</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 button class&#61;&#34;uk&#45;button uk&#45;button&#45;primary&#34;&#125;</code></td><td>Button with your own CSS classes</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 count&#125;</code></td><td>Only the number of times the download was fetched</td></tr> <tr><td><code>&#123;fileshelf cat&#61;3&#125;</code></td><td>List of the downloads of a category (main or additional)</td></tr> <tr><td><code>&#123;fileshelf cat&#61;3 layout&#61;cards limit&#61;5 order&#61;popular&#125;</code></td><td>Cards, at most 5, most popular first</td></tr> </tbody></table>

`{fsh …}` is the short form of `{fileshelf …}`. `order` knows `title` (default), `rtitle`, `newest`, `oldest`, `popular` and `ordering`; `limit` goes up to 100.

## What visitors see

- If the visitor may fetch the download, the link or button appears.
- If it is protected, the title and a lock with the link **Enter password** or **Log in** appear.
- An unknown, unpublished or expired download does not appear at all. In Joomla's debug mode an HTML comment with the reason stands in its place.

<div class="callout info" id="bkmrk-a-list-that-stands-a">A list that stands alone in a paragraph replaces the paragraph. So write <code>&#123;fileshelf cat&#61;…&#125;</code> on a line of its own.

</div>[Deutsche Fassung](https://docs.graup-it.de/link/402)