Skip to main content

Data Downloader: Custom Media File Names

Allow users to define custom names for media files when downloading their data.

Adrian Zuniga avatar
Written by Adrian Zuniga
Updated over a week ago

Users can dynamically name their media files while using the Data Downloader. This feature allows users to include tags within the record data to be populated in the file name of your downloaded record's media data.

Custom Media File Names

To customize the media file names, it is necessary to use the supported syntax which consists off adding brackets {} around the supported tag(s). Using - between tags may help with file name readability. Take a look at the example below:

In the 'Media File Name' field of the Download Options modal, we have set:

{title}-{record_id}

With this configuration, any new record would populate the record title and the record id in the file name for an individual media file.

Supported tags

Review the following table to learn more about the different tags available for naming your files when downloading your data:

Tag Name

Description (or Article Link)

{title}

{data_name}

{label}

{id}

The media's unique ID

{record_id}

The record's unique ID

{feature_id}

(Repeatable) record/child record ID

{titles}

(Repeatable) Title

{number}

(Repeatable) Number

Download Options

To access this feature, click the download data button from the Data Viewer of the app for which you want to download the data.

To get the process started, click the Download Data button on the top right of the record view.

Next, select "File Name" as the Media Fields selection, and be sure to check the media fields you wish to include.

Selecting File Name as the option for the Media Fields

The dropdown arrow on the left side of the download data button reveals the list of completed downloads as well as downloads in progress:

Data Download processing.

Once the download is finished processing, click the icon to save it to your computer:

Once the process is complete the download icon will be displayed right next to the file.

Notes

  • Things such as project, assignment, status, and captions are currently not supported for this feature.

  • Media files that have a repetitive (or empty) value will be numbered chronologically (eg photo-value-1.jpg, photo-value-2.jpg )

  • As always, use caution with repeatables. If you want a value to be included in the photo names within repeatables, the repeatable needs to have that field- their scope is limited to the repeatable itself, and will not be able to use parent data in their names. Using both a parent and child record data may help here, eg
    ​{parent_field}{repeatable_field}-{data_name}
    This way, media has a full file name no matter if it is in the parent or a repeatable.
    Parent media would come out as: {parent_field}-{data_name}
    Repeatable media would come out as: {repeatable_field}-{data_name}


​

Did this answer your question?