Overview The Export Configuration panel allows you to control how FileFetch organizes, names, and downloads your files. Configure these settings before exporting to ensure files land exactly where you want them, with the structure you need.
Export configuration settings are preserved between sessions. FileFetch remembers your preferences for future exports.
Export Type Choose which type of Salesforce files to export:
Files (ContentVersion)
Attachments
Modern Salesforce Files Export files from the Salesforce Files system (ContentVersion/ContentDocument).
Uses ContentDocument API
Supports versioning
Richer metadata available
Attached via ContentDocumentLink
Best For :
Files attached after Winter ‘12
Modern Salesforce implementations
Files with version history
Legacy Attachments Export classic Salesforce Attachments.
Uses Attachment API
No version support
Directly attached to parent records
Older file storage method
Best For :
Legacy data not migrated to Files
Attachments on older records
Simple attachment exports
Changing the Export Type resets your query and results. Make sure to select the correct type before querying.
File Organization When enabled, FileFetch organizes exported files into folders based on their parent Salesforce records.
Enabled (Recommended)
Disabled
Organized by Parent Record Files are grouped into folders named after the related record. Example Structure :FileFetch_Export_2024-10-01_143025/ ├── Acme_Corporation_001xx000000AAAAA/ │ ├── Contract_2024.pdf │ ├── Proposal_Q1.docx │ └── Logo.png ├── Beta_Industries_001xx000000BBBBB/ │ ├── Invoice_January.xlsx │ └── Product_Specs.pdf └── _Export_Summary.txt Folder Naming :
Format: {RecordName}_{RecordId}
Example: Acme_Corporation_001xx000000AAAAA
Sanitized for file system compatibility (special characters removed)
Use this option when you want files organized by customer, case, opportunity, or any parent object. Makes it easy to see which files belong to which record.
Flat Structure All files are exported to a single folder without subfolders. Example Structure :FileFetch_Export_2024-10-01_143025/ ├── Contract_2024.pdf ├── Proposal_Q1.docx ├── Logo.png ├── Invoice_January.xlsx ├── Product_Specs.pdf └── _Export_Summary.txt If multiple files have the same name, FileFetch will apply duplicate handling rules (see below).
File Naming Control how exported files are named:
Use Real File Names (Recommended) Original File Names Files are saved with their original names from Salesforce.
Files : Uses the Title field + file extensionAttachments : Uses the Name field Example :
Annual_Contract.pdfQ1_Invoice.xlsxProduct_Photo.jpg This is the most user-friendly option. Files have recognizable, meaningful names that match what’s in Salesforce.
Salesforce Record IDs Files are saved using their Salesforce IDs.
Files : Uses ContentDocumentIdAttachments : Uses Attachment Id Example :
069xx000000ABCDEA4.pdf069xx000000EFGHEA4.xlsx00Pxx000000IJKLEA4.jpg Use When :
You need to maintain exact ID tracking
Integrating with external systems that expect IDs
Avoiding any possible filename conflicts
Duplicate Handling When multiple files have the same name, FileFetch can handle duplicates in two ways:
Append ID
Skip Duplicates
Add Salesforce ID to Duplicate Names If a file with the same name already exists, append the ContentDocumentId or Attachment Id to make it unique. Example :Contract.pdf Contract_069xx000000ABCDEA4.pdf ← Duplicate, ID appended Contract_069xx000000EFGHEA4.pdf ← Another duplicate Recommended : This ensures all files are exported, even if they have identical names. You never lose data.
Skip Files with Duplicate Names If a file with the same name already exists, skip the duplicate and move to the next file. Example :Contract.pdf ← First file saved ← Duplicate skipped ← Another duplicate skipped Data Loss Risk : This can result in missing files if multiple files share the same name. Only use this if you’re certain file names are unique.
Export Summary will show:Files Skipped (Duplicates): 2 - Contract.pdf (ContentDocumentId: 069xx000000ABCDEA4) - Contract.pdf (ContentDocumentId: 069xx000000EFGHEA4) Export Location Default Export Folder FileFetch exports files to a default location on your computer:
Default Location : ~/Downloads/FileFetch_Exports/Each export creates a timestamped subfolder: ~/Downloads/FileFetch_Exports/ └── FileFetch_Export_2024-10-01_143025/ ├── [exported files] └── _Export_Summary.txt You can change the default export folder in Settings . Default Location : C:\Users\{YourName}\Downloads\FileFetch_Exports\Each export creates a timestamped subfolder: C:\Users\YourName\Downloads\FileFetch_Exports\ └── FileFetch_Export_2024-10-01_143025\ ├── [exported files] └── _Export_Summary.txt You can change the default export folder in Settings . Custom Export Folder (Coming Soon) Future Feature : The ability to select a custom export folder for each export is planned for a future release. For now, use the default location or change it in Settings.
Folder Naming Convention Export folders follow this naming pattern:
FileFetch_Export_{YYYY-MM-DD}_{HHMMSS} Example : FileFetch_Export_2024-10-01_143025
YYYY-MM-DD : Date of export (year-month-day)HHMMSS : Time of export (24-hour format)
This ensures:
Exports are easy to identify by date/time
No folder name conflicts (each export has a unique timestamp)
Chronological sorting in file explorer
Export Summary Every export includes an _Export_Summary.txt file with detailed information:
============================================== FileFetch Export Summary ============================================== Export Date: 2024-10-01 14:30:25 Export Type: Files (ContentVersion) Salesforce Org: https://your-domain.my.salesforce.com ============================================== Export Configuration ============================================== Grouped by Related Record: Yes Use Real File Names: Yes Duplicate Handling: Append ID Export Folder: /Users/you/Downloads/FileFetch_Exports/FileFetch_Export_2024-10-01_143025 ============================================== Export Results ============================================== Total Files Queried: 150 Files Successfully Downloaded: 147 Files Failed: 2 Files Skipped (Duplicates): 1 ============================================== Failed Downloads ============================================== 1. Invoice_March.pdf (ContentDocumentId: 069xx000000ABCDEA4) Error: Download timeout after 120 seconds 2. Report_Q2.xlsx (ContentDocumentId: 069xx000000EFGHEA4) Error: File not found or access denied ============================================== Skipped Files (Duplicates) ============================================== 1. Contract.pdf (ContentDocumentId: 069xx000000IJKLEA4) Reason: File with same name already exists ============================================== Download Statistics ============================================== Total Download Size: 1.2 GB Average File Size: 8.2 MB Download Duration: 5 minutes 32 seconds Average Download Speed: 3.6 MB/s Concurrent Downloads: 10 ============================================== The Export Summary is invaluable for auditing, troubleshooting, and tracking which files were exported. Always review it after large exports.
Recommended Settings For most users, we recommend:
Export Type Files (ContentVersion) for modern Salesforce data
Group by Related Record Enabled for organized folder structure
File Naming Use Real File Names for readability
Duplicate Handling Append ID to avoid data loss
Special Considerations Large Exports For exports with hundreds or thousands of files:
Enable grouping : Easier to navigate than a flat structure with 1000+ filesUse real file names : Helps identify files quicklyAppend ID for duplicates : Ensures all files are exportedMonitor Export Summary : Check for failed downloads
Integration/Automation If exporting for integration with external systems:
Disable grouping : Flat structure may be easier to process programmaticallyUse Salesforce IDs : External systems may expect ID-based namingSkip duplicates : If your workflow handles deduplication separatelyParse Export Summary : Programmatically read the summary file for results
Record-Specific Exports When exporting files for specific records (e.g., one Account’s files):
Enable grouping : Even for a single record, creates clear organizationUse real file names : Makes files immediately recognizableAppend ID for duplicates : Avoid losing files with same names
Changing Configuration Mid-Export You cannot change export configuration while an export is in progress. Wait for the current export to complete, then adjust settings for the next export.
If you need to stop an export:
Click Cancel Export in the progress dialog
Adjust your configuration
Re-run the export
Next Steps 
