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

Note:

  • 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:

×