Folders & Files

Last Updated: Apr 24, 2024
documentation for the dotCMS Content Management System

Managing Files

Files (both File Assets and dotAssets) may be managed from the Site Browser (Site –> Browser), Content Search screen, dotCLI, WebDAV (deprecated), or the REST API. All these methods allow you to upload, edit, publish, unpublish, and archive files. Files may be deleted via the back-end Content Search tool, the Site Browser, or REST API; files removed using WebDAV are archived rather than deleted.

Managing Folders

  • Folders may be managed only from the Site Browser, dotCLI, or WebDAV.
  • Unlike files, folders are not published, unpublished, or archived.
    • You may specify whether a folder is displayed in your site menus, but once a folder is created, the path to that folder is always accessible.
    • However it is the status and permissions of the files and pages within the folder which determine what content is accessible; if a folder contains files and pages which are unpublished, or which a user does not have permissions to access, the user will not be able to see any content even if they know the path and have permissions to access that folder.
  • Deleting a folder destroys all content, content versions, file assets, subfolders, etc., contained therein, including archived items.
    • Content associated with a folder will not be visible from the Site Browser, so it is important to confirm that nothing unintended will be lost when deleting a folder.

Reserved Names

The following names are reserved, and can not be used as a file or folder name (URL) for any files or folders at the root of your site:

  • assets
  • custom_elements
  • dotadmin
  • dotcms
  • dotsass
  • dotless
  • email_backups
  • html
  • meta-inf
  • portal
  • web-inf


  • These names are restricted regardless of case used (upper-case or lower-case).
  • Only names which match the above URLs exactly are restricted.
    • A file or folder name which includes any of the above terms as only part of the name (but not the entire name) is not restricted.

On this page


We Dig Feedback

Selected excerpt: