Using {File_Upload:count} Placeholder in RSForm!Pro for Multiple File Uploads

When working with File Uploads in RSForm!Pro, it's common to allow users to upload multiple files through a single file upload field. To handle and display these files dynamically in your emails, PDF layouts, or Thank You messages, RSForm!Pro provides a {File_Upload:count} placeholder.

This placeholder returns the number of files uploaded through a specific field.

 

Basic Use Case

When using a File Upload field (we'll name it simply 'File_Upload_Field_Name') with multiple uploads enabled (let's say we allow a maximum 5 number of uploads and the 'Add More Files' Button can be either enabled or disabled), RSForm!Pro allows you to reference individual files using the {File_Upload:count} placeholder, such as:

  • {File_Upload_Field_Name_0:path} - {File_Upload_Field_Name_0:filename}
  • {File_Upload_Field_Name_1:path} - {File_Upload_Field_Name_1:filename}
  • {File_Upload_Field_Name_2:path} - {File_Upload_Field_Name_2:filename}
  • {File_Upload_Field_Name_3:path} - {File_Upload_Field_Name_3:filename}
  • {File_Upload_Field_Name_4:path} - {File_Upload_Field_Name_4:filename}

However, if you want to customize the output depending on how many files were uploaded, {File_Upload_Field_Name:count} comes in handy.

The file count will always start with 0 for the first uploaded file.

 

Displaying Uploaded Files with Descriptive Text and Links

Below is a detailed example of how you can use {File_Upload_Field_Name:count} and {if} syntax to craft a list of uploaded files, with clickable links and filenames of your file upload field.

    {if {File_Upload_Field_Name:count} > 0}
    {if {File_Upload_Field_Name:count} == 1}
        <ul>
            <li>First Image: <a href="{File_Upload_Field_Name_0:path}" target="_blank">{File_Upload_Field_Name_0:filename}</a></li>
        </ul>
    {/if}
    {if {File_Upload_Field_Name:count} == 2}
        <ul>
            <li>First Image: <a href="{File_Upload_Field_Name_0:path}" target="_blank">{File_Upload_Field_Name_0:filename}</a></li>
            <li>Second Image: <a href="{File_Upload_Field_Name_1:path}" target="_blank">{File_Upload_Field_Name_1:filename}</a></li>
        </ul>
    {/if}
    {if {File_Upload_Field_Name:count} == 3}
        <ul>
            <li>First Image: <a href="{File_Upload_Field_Name_0:path}" target="_blank">{File_Upload_Field_Name_0:filename}</a></li>
            <li>Second Image: <a href="{File_Upload_Field_Name_1:path}" target="_blank">{File_Upload_Field_Name_1:filename}</a></li>
            <li>Third Image: <a href="{File_Upload_Field_Name_2:path}" target="_blank">{File_Upload_Field_Name_2:filename}</a></li>
        </ul>
    {/if}
    {if {File_Upload_Field_Name:count} == 4}
        <ul>
            <li>First Image: <a href="{File_Upload_Field_Name_0:path}" target="_blank">{File_Upload_Field_Name_0:filename}</a></li>
            <li>Second Image: <a href="{File_Upload_Field_Name_1:path}" target="_blank">{File_Upload_Field_Name_1:filename}</a></li>
            <li>Third Image: <a href="{File_Upload_Field_Name_2:path}" target="_blank">{File_Upload_Field_Name_2:filename}</a></li>
            <li>Fourth Image: <a href="{File_Upload_Field_Name_3:path}" target="_blank">{File_Upload_Field_Name_3:filename}</a></li>
        </ul>
    {/if}
    {if {File_Upload_Field_Name:count} == 5}
        <ul>
            <li>First Image: <a href="{File_Upload_Field_Name_0:path}" target="_blank">{File_Upload_Field_Name_0:filename}</a></li>
            <li>Second Image: <a href="{File_Upload_Field_Name_1:path}" target="_blank">{File_Upload_Field_Name_1:filename}</a></li>
            <li>Third Image: <a href="{File_Upload_Field_Name_2:path}" target="_blank">{File_Upload_Field_Name_2:filename}</a></li>
            <li>Fourth Image: <a href="{File_Upload_Field_Name_3:path}" target="_blank">{File_Upload_Field_Name_3:filename}</a></li>
            <li>Fifth Image: <a href="{File_Upload_Field_Name_4:path}" target="_blank">{File_Upload_Field_Name_4:filename}</a></li>
        </ul>
    {/if}
{/if}

Make sure to replace 'File_Upload_Field_Name' with the actual name of your File Upload field.

 

Was this article helpful?

Yes No
Sorry about that