.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../Includes.txt



.. _content-element-uploads:

==========
File links
==========

This content element gives you the opportunity to offer downloadable files to the visitors of your website.

.. figure:: Images/BackendFieldsFiles.png
   :alt: Backend display of the fields for the File links in the General tab

   The "General" file links fields

You can add or select single files but also use a file collection. A file collection can be one of the following:

- A static selection of files

- A folder within a storage, holding the files

- A file selection by category

When combining both methods, single files and file collections, all files from these methods will be presented to the
website visitor.

.. figure:: Images/BackendTabAppearance.png
   :alt: Backend display of the Appearance tab for the File links

   The "Appearance" settings for file links

In the ``Appearance`` tab you will find several options how the files will be presented:

- ``Display file/icon/thumbnail`` - In this dropdown you can select if you only want to show the file name, the file name
  and a corresponding icon, based on the file extension, or the file name with a thumbnail, if it is possible for TYPO3
  CMS to generate a thumbnail from the file.

- ``Display file size information`` - Will show the file size calculated from the amount of bytes and presented as a human
  readable string with the proper unit (B, KB, MB ...).

- ``Display description`` - Will display the description of each file, if available.

.. figure:: Images/Frontend.png
   :alt: Frontend rendering of a file, with thumbnail, description and file size set

   Frontend output of a file, with thumbnail, description and file size set