In Cascade files, you will see many folder names that begin with underscore. We use the underscore to bring these important folders to the top of lists. Cascade orders folders alphabetically, and considers the underscore character to be before the letter "A." By putting underscores in front of commonly-used folders and files, we make them jump to the top of a list so you don’t have to scroll around to find them. This concept also applies to using "z-" which pushes a folder/file to the end of the list if we generally don't want to see them, like the "z-archive" folder (see below). Some examples of these special folders include:

"_content" folders

All websites should already have a "_content" folder in your main folder. These "_content" folders are for placing content blocks into. However, many websites have hundreds of pages and a single "_content" folder should probably not contain the hundreds of content blocks for all of those pages. Instead, you should create folders to section the pages into smaller groups, and add a new "_content" folder inside each of those folders.  Here is an example of a "_content" folder inside the arboretum folder:


When you have "_content" folders in each directory of your site, they will be easier to locate and closer to your pages. You will also have less naming problems. For example, if you have two pages with the same name, but in different folders (for example people/index and about/index), you wouldn’t be able to name both content files "index-content." Instead, you can create separate "_content" folders in the "people" and "about" folders. This way, both content files can be named "index-content" because they are in different places and still organized.

"_images" folder

At the top of your folder listings, you will see an "_images" folder. This folder contains a subfolder for your website along with these:

These are available for anyone to use and are generic in nature, meaning they could be appropriate for many purposes. If you provide your own images, you should add them to the folder for your website within the "/_images" folder.

"_files" folders

Within your website, you may have a "_files" folder which should contain documents that are not web-pages, such as PDFs. If you do not have a "_files" folder, you should create one (using "_files" for all title fields). Documents that are not PDFs, such as Microsoft Office documents, should be converted to PDFs before being added to your "_files" folder in Cascade, since PDFs are more universally compatible.

Convert Word Document to PDF

  1. Click the link to open Word to PDF converter in your browser:
  2. Select the Choose File button and select the Word document from your computer


  3. When the document has been uploaded, select the Convert Now button


  4. Once the file has been converted to a PDF, select the Download PDF button


  5. The PDF file will be saved in Downloads with the same name as the Word document.


  6. If the file name does not follow the Cascade naming guidelines, right-click to rename the file. In this example, this file needs to be renamed eliminating the underscore, spaces, and capital letters. It should be named "cascade-user-guide-health-center.pdf" before it is uploaded to Cascade.


"_links" folders

Within your website folders, you may have a "_links" folder which should contain HTML Links. When you are linking to somewhere outside of your website (either within or outside, you have to create an external link as shown here:


When you want to add an external link to more than one place, it is useful to use HTML Links. This way, all the links trace back to the HTML Link allowing you to change it from one place if you ever need to, rather than having to edit each of the links individually. See HTML Links.

"z-archive" folders

"z-archive" folders are like recycling bins that never have to be emptied; this is where you should place documents that you don't want on your website. Documents moved into "z-archive" folders will be removed from your website, but never destroyed. The "z" puts the folder at the bottom of your file listing so you don’t see it all the time. You can have as many "z-archive" folders as you want, but you must have one at the root of your website, and it must be set to not publish or be indexed as shown here in the folder's Properties settings:


Contact if you do not have a "z-archive" folder.

Creating folders

  1. Select Add Content > _ALL > Folder
  2. Name the folder
    1. For an organizational folder, choose a name that follows the naming guidelines for all files
    2. Underscore folders should be named after the type of folder they are. For "_content" folders, the folder name, display name, and title fields should all be "_content." This applies to "_files," "_links," and "z-archive" folders as well. 
  3. Choose the correct placement folder
  4. For special folders, adjust Properties

    IMPORTANT: On properties tab of "_content" folders uncheck the "Include when publishing" and "Include when indexing" checkboxes so no content blocks can be published until they are wired up. Do the same for "z-archive" folders so that nothing in those folders can be published. 

  5. Submit

Back to Top