Nested Folder Settings
A nested Folder Setting occurs when the same Folder Setting is defined on a folder and again on one of its subfolders. Files.com determines how the two definitions interact within the overlapping folder scope.
Nesting applies only when the same Folder Setting is used at multiple levels of the folder hierarchy. A Folder Setting of a different type defined on a subfolder applies independently and does not interact with the Folder Setting defined above it.
When Folder Settings Are Considered Nested
Folder Settings are nested only when all of the following are true:
- The same Folder Setting is defined more than once
- Each definition exists at a different level of the folder hierarchy
- The definitions apply to overlapping folder scopes
How Nested Folder Settings Interact
Each Folder Setting has a fixed interaction model that determines how nested instances of that same setting behave. The model is built into the platform and is not configurable.
Nested Folder Settings interact in one of two ways.
Combine Effect
For some Folder Settings, multiple definitions are combined where they overlap. The Folder Setting defined on the folder and the Folder Setting defined on the subfolder are both in effect at the subfolder level.
Combine applies when cumulative configuration is meaningful and applying multiple definitions together produces a predictable result.
Combine Example
Assume the Send Email Folder Setting is configured on the /Projects folder to send an email notification to project_team@example.com when a file is uploaded.
Another Send Email Folder Setting is configured on the /Projects/2026 subfolder to send an email notification to finance@example.com.
Because Send Email is a Folder Setting whose nested effect is Combine, both configurations are active where their scopes overlap:
- A file uploaded to
/Projectstriggers one email sent toproject_team@example.com. - A file uploaded to
/Projects/2026triggers two emails:- One sent to
project_team@example.com(from the setting on/Projects) - One sent to
finance@example.com(from the setting on/Projects/2026)
- One sent to
The subfolder setting does not replace the setting defined higher in the folder hierarchy. Both settings apply together at the subfolder level.
Replace Effect
For other Folder Settings, a definition on a subfolder replaces the definition from the folder above it. Only the Folder Setting defined at the subfolder level is in effect within that subfolder's scope.
Replace applies when only one active configuration can apply at a given location and a more specific definition takes precedence.
Replace Example
Assume the File Expiration Folder Setting is configured on the /Projects folder to automatically delete files after 30 days.
Another File Expiration Folder Setting is configured on the /Projects/2026 subfolder to automatically delete files after 7 days.
Because File Expiration is a Folder Setting whose nested effect is Replace, the lower-level configuration takes full effect where their scopes overlap:
- A file uploaded to
/Projectsexpires after 30 days. - A file uploaded to
/Projects/2026expires after 7 days.
The subfolder setting replaces the setting defined higher in the folder hierarchy. The higher-level expiration rule does not apply within the /Projects/2026 subfolder.
Nested Effects by Folder Setting
The table below lists how each Folder Setting behaves when the same Folder Setting is defined at multiple levels of a folder hierarchy.
| FOLDER SETTING | NESTED EFFECT |
|---|---|
| Archive Removed Files | Replace |
| Automatically Create New User Folders Here When Users Are Created | Combine |
| File Expiration | Replace |
| GPG Encryption/Decryption/Recryption | Replace |
| Inboxes | Combine |
| Limit Uploaded Files by File Name Length | Replace |
| Limit Uploaded Files by Regular Expression | Replace |
| Limit Uploaded Files to Certain File Extensions | Replace |
| Lock Subfolders | Replace |
| Publicly Serve (Web Hosting) | Combine |
| Publish Events to Amazon SNS Topic | Combine |
| Rename Uploaded Files | Replace |
| Send Email Notifications | Combine |
| Send Slack Notifications | Combine |
| Send Webhook | Combine |
| Storage Location (Region) | Replace |
| Watermark Previews | Replace |
Relationship to Recursion and Inheritance
Nested Folder Settings describe how multiple definitions of the same setting interact when they overlap. Other Folder Setting concepts determine whether those definitions overlap in the first place.
Recursion determines whether a Folder Setting applies only to the folder where it is defined or also applies to subfolders. See Recursion: Where Settings Apply.
Non-recursive Folder Settings also establish inheritance boundaries, preventing a Folder Setting defined at a higher level from applying further down the folder hierarchy. See How Non-Recursive Settings Affect Inheritance.
Get The File Orchestration Platform Today
4,000+ organizations trust Files.com for mission-critical file operations. Start your free trial now and build your first flow in 60 seconds.
No credit card required • 7-day free trial • Setup in minutes