Customize Output File Names in DocuFreezer

DocuFreezer lets you customize how output files are named during document conversion. You can adjust the default output name in several ways:

  • Keep it as is (no changes)
  • Use your own custom text
  • Use built-in macros to pull data from the source file's metadata
  • Combine text and macros

This article shows you how to rename files, add page or worksheet numbers, and use advanced customization such as adding leading zeros for consistent file naming.

Adjusting file names with the Output filename template setting

You can freely modify the output file name template by entering your own text or adding characters such as dots, dashes, underscores, and more. 

Important: Avoid using the following characters, as they are prohibited in Windows filenames:
< (less than)
> (greater than)
: (colon)
" (double quote)
/ (forward slash)
\ (backslash)
| (vertical bar)
? (question mark)
* (asterisk)

This restriction does not apply to macros — macros may contain any characters.

To modify the output naming pattern, open DocuFreezer Settings Advanced and find the Output filename template setting:

Output filename template in DocuFreezer

Here you can use your custom text and/or macros. For example, macro {*SrcFilename} inserts the original source file name. By default, DocuFreezer uses the following template for output filenames:

{*SrcFilename}{*WorksheetName}{*SrcFileMPageNo}.{*DstFileExt}

  • {*SrcFilename} – stands for source file name;
  • {*WorksheetName} – stands for worksheet file name (usually applicable for Excel or CAD files);
  • {*SrcFileMPageNo} – stands for source file page number ("M" implies "multiple pages", hence this macro avoids adding page number "1" to single-page files);
  • {*DstFileExt} – stands for destination file extension.

This template combines the source filename, worksheet name (if applicable), page number, and destination file extension. You can adjust this template to suit your needs.

Using macros to change filename

To access built-in macros, click the {=} icon in the DocuFreezer Settings. A macro is a value or expression that pulls data from the metadata of the source file. This data can include the filename, file path, file attributes (such as creation date and time), or other details like the computer's or user’s name. Most macros extract information directly from the source file’s metadata. If the data is missing in the source file, it will be omitted. 

Using macros to change filename

Insert macros via the {=} icon or type them manually. If entered correctly, the macro name will turn light green. You can combine macros with your own text, including spaces, dots, or other characters, to create a custom naming pattern.

Note: Macro names are not case-sensitive, so {*dstfileext} and {*DstFileExt} will function identically.

View description of all macros that can be used →

Adding leading zeros to source file page numbers when splitting a document

When DocuFreezer processes a document and splits it into multiple pages or worksheets (e.g., saved as image files), it adds numerical endings to the filenames. This prevents files with the same name from being overwritten. Examples include:

  • A multi-page PDF gets split into separate images (JPG, PNG, TIFF).
  • An Excel file with multiple worksheets converted into an image format (JPG, PNG, TIFF).
  • A PDF split into single pages during conversion.

If the number of pages is 10 or fewer, files will be named file-1.pdf, file-2.pdf, file-3.pdf, and so on. For 11 to 100 pages, the naming shifts to file-01.pdf, file-02.pdf, file-03.pdf, up to file-100.pdf. You can customize this further by adding more digit positions and leading zeros. For instance, you can change the naming from Document-2 to Document-000002.

To adjust this in DocuFreezer:

  1. Open the Settings panel → Advanced.
  2. Next to Output filename template, remove the default macro {*SrcFileMPageNo}.
  3. Click the {=} icon, navigate to Pages, and select Source file page number, 3-digit number / 001 (or another desired option). The Output filename template will be:
    {*SrcFilename}{*WorksheetName}{*SrcFileMPageNo(_{0:D3})}.{*DstFileExt}
  4. Save the settings and test the configuration with a few files.
Adding leading zeros to source file page numbers

After conversion, your output files should reflect the updated naming with three-digit numbers (e.g., Document-001, Document-002).

You can further tweak the {*SrcFileMPageNo(_{0:D3})} macro to fit your preferences. For example:

  • Replace the underscore (_) with a dash (-) to get names like "A nine-page document-001.png".
  • Adjust the number of leading zeros by changing D3 to D2, D4, D5, or D6 (e.g., D4 yields Document-0001).

Test your configuration with a small batch of files to ensure the naming meets your requirements. With DocuFreezer’s flexible naming options, you can streamline file organization and maintain consistency across your converted documents. 

Adding Bates numbering to output filenames

DocuFreezer can both add Bates numbers in the form of a Text watermark, similar to page numbers and implement them in the output filenames. Bates number typically adds a file identifier in uppercase letters and a sequential page number starting from the last processed document.

For more details, please refer to this article:
How to Add Bates Numbering to PDF Files in DocuFreezer

Naming of combined PDF or TIFF files

When creating a multipage PDF document or TIFF image, you can control the output filename through the Combined file setting. Since multiple files are usually merged, there should be a user-specified name for the output file. While the default name is "Combined.pdf" (or "Combined.tiff"), you can change it to any name you prefer and use macros if necessary (for example, add User name {User} or Computer name {Computer} to the output filename). 

Setting filename for a merged multi-page TIFF or PDF  

Didn't find your desired naming format?

If you need a specific naming pattern that was not covered in this article, please don't hesitate to contact our developers directly for a custom solution.