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:

System 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. System 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.
System Names for files (.pdf, .doc, .xls, .ppt etc. and image formats - .jpg, .png etc.) must contain a file extension.

You can change the system name using “Move/Rename," however, try to avoid changing system names if possible. If you do need to change the system 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” tab, then click on "Metadata" (right under "Edit") to reach the "Display Name" field. Un-publishing is not necessary.

Title

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

To change the Title, click the “Edit” tab and change the text in the "Title" field. Un-publishing is not necessary.

Index pages are a special case.

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