# Options and permissions

You reach the options with the button **Options** on the dashboard and in the list of downloads.

<figure id="bkmrk-the-options%2C-tab-%E2%80%9Cst"> ![The options of Fileshelf with the tab Storage](https://docs.graup-it.de/uploads/images/gallery/2026-11/4ludoku-10-optionen.png) <figcaption>The options, tab “Storage”.</figcaption></figure>## Storage

<table class="table" id="bkmrk-optiondefaultmeaning"> <thead> <tr><th scope="col">Option</th><th scope="col">Default</th><th scope="col">Meaning</th></tr> </thead> <tbody> <tr><td>Storage folder</td><td><code>fileshelf</code></td><td>Relative to the Joomla folder or an absolute path. Safest outside the web directory.</td></tr> <tr><td>Allowed file types</td><td>pdf, zip, docx, xlsx, pptx, jpg, jpeg, png, mp3, mp4</td><td>Extensions, separated by commas. Programs and web pages are never accepted.</td></tr> <tr><td>Allow software packages</td><td>No</td><td>Accepts archives with program code, such as extensions for Joomla, Shopware or WordPress (see *Creating and maintaining downloads*). In the backend only, and only with a protected storage folder.</td></tr> <tr><td>Maximum file size (MB)</td><td>100</td><td>0: no limit of its own. The server's limit always applies.</td></tr> <tr><td>Delivery</td><td>PHP</td><td>PHP, X-Sendfile or X-Accel-Redirect (see *Storage folder and self-test*)</td></tr> </tbody></table>

## Downloads

<table class="table" id="bkmrk-optiondefaultmeaning-1"> <thead> <tr><th scope="col">Option</th><th scope="col">Default</th><th scope="col">Meaning</th></tr> </thead> <tbody> <tr><td>Access through additional categories</td><td>Main category only</td><td>“Strictest”: the access levels of the additional categories must allow it as well.</td></tr> <tr><td>Password valid for (minutes)</td><td>120</td><td>0: until the browser session ends.</td></tr> <tr><td>Versions</td><td>Yes, 10</td><td>Version history of the downloads as with articles.</td></tr> </tbody></table>

## Display

Layout (list with category tree, cards, table), search and sorting, and which details the lists show: file type and size, version, date, number of downloads, tags – and whether locked downloads appear with a lock. Menu items and the module can choose each detail differently. **Checksum** shows the SHA-256 checksum of the file on the page of a download (default: off). **Category Image** shows the category's image at the top of the category and in the overview (default: on); **Category image layout** puts it beside the text (default, never cropped) or as a banner across the full width. **Heading of the overview** and **Introduction of the overview** stand above the categories of the download overview; a menu item can override both (see *Downloads on the website*).

## Appearance

How Fileshelf fits into your template (see *Fitting your template*). Left empty, the colours and corners of the template apply.

- **Load the Fileshelf stylesheet** – “No” for templates that style Fileshelf themselves. Then the arrangement of grids and spacing is missing too.
- **Accent colour** – for buttons, markers and, if it reads well on white, links. Fileshelf picks light or dark text on buttons itself.
- **Corners** – as the template, square or rounded.

## Integration

**Remove IDs from URLs** (default: yes) and **Enable custom fields** as with articles.

## Permissions

Permissions follow the pattern of articles and are inherited from the component through the category to the download: create, edit, edit own, edit state, delete. In addition:

- **Download in the backend** – allows fetching a file in the backend without it being counted.
- **View statistics** – shows the download statistics of the Pro version (page, tab, tile). In the Free version it has no effect; it is there so the setting survives a switch.
- **Upload on the website** – allows uploading files into the category through the page “Upload a file” of the Pro version; they wait for approval. This permission is in the Free version, too.

Who may download on the website is decided by access levels (and a password, if any), not by permissions. The tools require the permission “Configure ACL &amp; Options”.

[Deutsche Fassung](https://docs.graup-it.de/link/408)