Naming conventions

Cascade uses different names for different purposes. Understanding the names and using the proper naming conventions is very important.

There are three types of names that you need to be familiar with:

Asset Name

This is the system identifier for your web asset (file, page, folder, block, etc.). It will be used in the URL and in the folder structure. Asset names should:

  • Contain all lower case letters.
  • Contain no spaces, punctuation, or symbols (use dashes for spaces).
  • Contain key words that make it clear what the page is.

Asset Names for pages : The new version of Cascade auto-generates the Asset Name by converting the page Title using the proper naming convention, so it is important to carefully choose the page Title when you initially create a page. 

Asset Names for files (.pdf, .doc, .xls, .ppt etc. and image formats - .jpg, .png etc.) must contain a file extension.

You can change the asset name by clicking on "... More", then "Rename" however, try to avoid changing asset names if possible. If you do need to change the asset name of a page, file, or folder, the asset must be un-published to avoid leaving orphaned pages on the public-facing web server. If you do not have publishing access to the public-facing web server, submit a request to INFOHELP and ask that they perform the rename action for you.

Note: index pages are a special case.

Display Name

This is the name that will be displayed in the tab or left navigation and in breadcrumbs.

To change the Display Name, click the "Edit" icon, then change the text in the "Display Name" field and click on "Save & Preview", then click on "Submit"  to save the change. Un-publishing is not necessary.

Title

This displays across the top of your page as the title.

To change the Title, click the "Edit" icon, then change the text in the "Title" field and click on "Save & Preview", then click on "Submit"  to save the change. Un-publishing is not necessary.

Index pages are a special case.

Every navigation folder that is published must contain a page with the name "index." These pages can have their own Display Name and Title, like any other page, but the page name must be "index" for the contents of the folder to display properly.