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.
Next, select "File Name" as the Media Fields selection, and be sure to check the media fields you wish to include.
The dropdown arrow on the left side of the download data button reveals the list of completed downloads as well as downloads in progress:
Once the download is finished processing, click the icon to save it to your computer:
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}