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

Place all the default root files and folders you would like to include in your site in this folder.

What it is

Files placed in #/Root/ are exposed at the top of your published site. A file at #/Root/style.css is reachable as /style.css, and #/Root/favicon.ico becomes /favicon.ico.

Use this folder for assets and pages that should live at the root of your domain — favicons, robots.txt, shared stylesheets, JavaScript bundles, the home page.

Common use cases

  • Site-wide assets#/Root/style.css, #/Root/main.js, images and fonts

  • Conventional files#/Root/favicon.ico, #/Root/robots.txt, #/Root/sitemap.xml

  • Home page#/Root/index.hash is served at /

  • Custom error pages#/Root/404.hash, #/Root/500.hash

Resolution order

#/Root/ is the workspace-wide fallback. When a request hits the root path, Docly looks in this order:

  1. An actual document or folder at that path

  2. #/Root/ (workspace-wide root defaults)

#/Folder/ is consulted for requests inside a folder; #/Root/ is consulted for requests at the top level. See The "Folder" folder for the per-folder counterpart.

Example

A minimal #/Root/index.hash that acts as the site's home page:

<!DOCTYPE html>
<html>
<head>
    <title>My workspace</title>
    <link rel="stylesheet" href="/style.css">
</head>
<body>
    <h1>Welcome</h1>
    <p>This page is served from #/Root/index.hash.</p>
</body>
</html>

Other root-level files referenced in this template (/style.css) are resolved from #/Root/style.css automatically. See Site.json config file for redirects, CORS and other domain-level settings.