`{exp:assets:files}`¶

You can use the {exp:assets:files} tag pair to loop through files managed by Assets.

{exp:assets:folders keywords="drink" recursive="yes"}
    <h3>{folder_name}</h3>
    <ul>
        {exp:assets:files folder_id="{folder_id}"}
            <li><a href="{url:huge}" target="_blank">{if title != ""}{title}{if:else}{filename}{/if}</a></li>
        {/exp:assets:files}
    </ul>
{/exp:assets:folders}

Tag Parameters¶

{exp:assets:files} supports the following parameters:

folder

The path of the folder containing the files you wish to output. Set this parameter in the format of either “{filedir_X}optional/subfolder/path” or “{source_X}optional/subfolder/path”. You may pass multiple IDs, delimited by pipes (‘|’). You can also use “any” or “*” to list from all folders.

folder_id

The ID of the folder containing the files you wish to output. You may pass multiple IDs, delimited by pipes (‘|’).

keywords

Search for files by their metadata values. You may pass multiple values, delimited by pipes (‘|’) or double-ampersands (‘&&’).

fixed_order

Search for files by their ID in the exp_assets_files table (same as the file_id param), and output them in the same order as they were entered into the param. You may pass multiple values, delimited by pipes (‘|’).

offset

Skips the first X files

limit

Limits the number of files to be returned

orderby

Orders the files by a specified property. Possible values include:

file_id
name
folder
date
size

sort

Sorts the results. Can be set to “desc” or “random”.

Note: Either the folder or folder_id param must be present for {exp:assets:files} to output anything.

Variable Tags¶

{exp:assets:files} supports the following variable tags:

{url}

The URL to the file.

{url:manipulation_name} is also available, for outputting the URL to an image manipulation.

{revved_url}

The revved URL to the file. The filename will be suffixed with a dot and the timestamp of when file was last modified. This will only work for files that are stored locally.

{server_path}

The server path to the file.

{server_path:manipulation_name} is also available, for outputting the server path to an image manipulation.

{subfolder}

The subfolder that the file lives in, if any.

{source_subfolder}

The value of the Subfolder setting on the file’s source, if there is one.

{folder_id}

Id of the folder containing the file.

{source_id}

Id of the source containing the file.

{filename}

The name of the file, sans-extension.

{extension}

The file extension.

{date_modified}

The date/time that the file was last modified. Supports the format parameter.

{kind}

The kind of file it is. Possible values are:

access

audio

excel

flash

html

illustrator

image

pdf

photoshop

php

text

video

word

{width}

The width of the image.

{width:manipulation_name} is also available, for outputting the width of an image manipulation.

{height}

The height of the image.

{height:manipulation_name} is also available, for outputting the height of an image manipulation.

{size}

The formatted size of the file (e.g. “20 KB”). You can also pass unformatted="yes" to get the raw file size in bytes.

{size:manipulation_name} is also available, for outputting the file size of an image manipulation.

{file_id}

The ID of the file (based on the id column in the exp_assets_files table).

{title}

The value of the file’s Title metadata field.

{date}

The value of the file’s Date metadata field. Supports the format parameter.

{alt_text}

The value of the file’s Alt Text metadata field.

{caption}

The value of the file’s Caption metadata field.

{author}

The value of the file’s Author/Credit/Producer metadata field.

{desc}

The value of the file’s Description metadata field.

{location}

The value of the file’s Location metadata field.

{total_files}

The total number of files being output.

{exp:assets:files}¶

Tag Parameters¶

Variable Tags¶

`{exp:assets:files}`¶