Skip to main content

Custom file naming

To use a custom naming convention for a Job's file attachments:

  1. Edit the Job.
  2. Choose Add Action and select one of the delivery Actions (see Adding Actions to a Job).
  3. Click + Attachments, choose your Query, then the file type.
  4. In the Filename field, combine date and timestamp tokens with the file name you want.

The available tokens are:

  • <%= ts %> — the current Unix timestamp in milliseconds.
  • <%= date(fmt) %> — today's date; fmt defaults to YYYY-MM-DD. See the Moment.js formatting docs for the format tokens.
  • <%= customDate(shift, fmt) %> — a shifted date, for example <%= customDate({day: -1}, 'YYYY-MM-DD') %> for yesterday.
  • <%= burst %> — the current burst key in a batch (burst) upload.

For example, for a file generated on March 1, 2026 at 12:30 PM:

<%= date() %> - MyExport.pdf                          =>  2026-03-01 - MyExport.pdf
<%= date('MM/DD/YYYY hh:mm') %> - MyExport.pdf        =>  03/01/2026 12:30 - MyExport.pdf
<%= customDate({day: -5}, 'MM/DD/YYYY') %>-MyExport.pdf  =>  02/25/2026-MyExport.pdf

Offsets from server time​

The custom naming convention uses the server time for its date and time values. For servers in another time zone, such as Informer Cloud (UTC), exports follow the server time, which may not be what you want. To offset to a local time, shift the hours by your GMT offset. For example, Eastern Daylight Time (GMT-4):

<%= customDate({hour: -4}, 'YYYY/MM/DD') %> - MyExport.pdf

For more, see Adding Actions to a Job and Scheduling a Job.