Skip to main content


<r:files:{attr} />

A tag used to loop through files like images, PDF's, audio files and more.

Attribute Options

labels="my-label,donkey" - The labels you want to add to the loop.

types - The type(s) of files you want to display. Valid options are audio, document, file, image, pdf and video.

labels_match - Specifies how you should match your labels. Valid options are any, all, or none.

by - The field which order sorts by. Valid options are the same as those listed when you edit a file's properties.

order - Sort the outputted items by ascending or descending. Valid options are asc or desc.

random - Boolean. Valid options are true or false. Pulls a random file every 30 seconds from within the loop.


<r:files labels="tag1,tag2" types="image" labels_match="any" by="title" order="asc" random="false">
  <ul class="thumbnails">
        <a href="<r:file:image_url />">
          <r:file:image_tag size="250x250" alt="{file:alt_text}" />

Last updated on July 28, 2015.

We welcome all questions, feedback and bug reports. If you're having an issue, we usually need the following information:

  • A brief description of the issue
  • A link to the page where you saw the issue
  • Screenshots that illustrate the problem - How do I take a screenshot?

Kindly email for help or use the form on the request help page.