The "Folder" folder Last updated: 26. Apr 2026

Place all the default files for all folders except the root folder here. If you have a folder somewhere, the contents in this folder will be available there.

What it is

Files placed in #/Folder/ become defaults available inside every folder of your workspace, except the root. Think of it as a fallback layer: if a folder does not provide its own version of a file, the one from #/Folder/ is used.

This is how you give every folder the same listing page, the same shared CSS, or the same display template — without copying the file into each folder.

Common use cases

Default folder index — #/Folder/index.hash renders a listing for every folder that does not have its own index.hash
Shared assets — #/Folder/style.css is reachable as style.css inside every subfolder
Default display templates — schemas without a workspace-wide display template can fall back to #/Folder/<schema>.hash

How resolution works

When Docly receives a request for a file inside a folder, it looks in this order:

The folder itself
Any parent folder that contains a matching file
#/Folder/ (the per-folder defaults)
#/Root/ (the workspace-wide root defaults)

The first match wins. This means a folder can always override a default by providing its own file with the same name.

Example

A typical #/Folder/index.hash that lists the contents of any folder:

<!DOCTYPE html>
<html>
<head>
    <title>#folder.name#</title>
</head>
<body>
    <h1>#folder.name#</h1>
    <ul data-loop="folder.children">
        <li><a href="#child.url#">#child.name#</a></li>
    </ul>
</body>
</html>

See The "Root" folder for workspace-wide defaults, and Templates & Rendering for the full template syntax.