Skip to content

File Settings

In this section, you can configure file settings for a specific form. You can configure the file name convention (including custom templates per upload field), file visibility, and expiration time for presigned URLs when files are set to private.

Configure File Settings

File Settings

The File Settings allow you to configure how files should be named and their visibility when uploaded to cloud storage for a specific form.

File Name Convention

The File Name Convention option determines how uploaded files should be named in your cloud storage.

  • Encrypted: Generates a unique encrypted name for each uploaded file. This option provides enhanced security and privacy by obscuring the original filename.
  • Original: Keeps the original filename as uploaded by the user. This option maintains the original file names for easier identification and organization.
  • Custom (Pro): Builds your own filename template for each upload field using smart codes, such as the original filename, submission ID, form ID, or any submitted form field value. Requires an active Pro license.

Choose how uploaded files should be named. Encrypted generates a unique name, Original keeps the original filename, and Custom builds a name from a template you define.

Custom File Names (Pro)

When you select Custom, a template row appears for each file upload field on the form. Enter a naming template for each field, and click the shortcode icon in any input to insert the available smart codes.

Available Smart Codes

The following smart codes can be used in your custom filename templates:

  • {form_title} - Title of the form
  • {submission.id} - Submission ID
  • {inputs.field_name} - Field value of the field name (e.g. {inputs.field_name} will be replaced with the value of the field name)
  • {date.Y-m-d} - Current date (Y-m-d)

How Templates Resolve

  • The file extension is added automatically from the original upload, so you do not need to include it in your template.
  • Leaving a field's template empty keeps the original filename.
  • Names are sanitized for safe storage, with invalid characters removed. An empty result falls back to the original filename, or file if that is also empty.

Single and Multiple Uploads

  • Single upload: Uses the resolved name as-is, for example invoice-2026.pdf.
  • Multiple uploads in one field: Appends -1, -2, -3 before the extension, for example invoice-2026-1.pdf and invoice-2026-2.pdf.

The Preview panel below the templates shows example output for both single and multiple uploads.

File Visibility

The File Visibility option determines the access level of uploaded files in your cloud storage.

  • Private: Files are set to private with restricted access.
  • Public: Files are set to public and are accessible via direct URL without login. Public files can be accessed by anyone who has the direct link.

The behavior of private files varies depending on your cloud storage service:

Google Drive

When files are set to Private in Google Drive, it requires login to access. Users must have proper credentials and authorization to view or download private files.

Dropbox

When files are set to Private in Dropbox, it requires login to access. Users must have proper credentials and authorization to view or download private files.

Microsoft OneDrive

When files are set to Private in Microsoft OneDrive, it requires login to access. Users must have proper credentials and authorization to view or download private files.

Amazon S3

When files are set to Private in Amazon S3, it does not require login to access. Instead, Amazon S3 uses presigned URLs that provide temporary access to private files. You can configure the expiration time for these presigned URLs, allowing secure access without requiring login.

Cloudflare R2

When files are set to Private in Cloudflare R2, it does not require login to access. Instead, Cloudflare R2 uses presigned URLs that provide temporary access to private files. You can configure the expiration time for these presigned URLs, allowing secure access without requiring login.

Expiration Time (Minutes)

For Cloudflare R2 and Amazon S3 cloud storage services, you can configure the expiration time for presigned URLs when files are set to private.

  • Expiration Time (Minutes): Set how long the presigned URL will be valid for private files. You can set a value between 1 minute to 7 days (10,080 minutes). The default value is 60 minutes.
  • Use the increment (+) and decrement (-) buttons or enter a value directly in the input field to set the desired expiration time.

TIP

Presigned URLs allow temporary access to private files without requiring login. Once the expiration time elapses, the presigned URL will no longer be valid. This feature is only available for Amazon S3 and Cloudflare R2. Google Drive and Dropbox require login for accessing private files.

Save Settings

After configuring your file settings, click the Save Settings button to apply the changes to the selected form.

Released under the GPL v2 License.