Discover Your Island

How Navigational Menus Work

Cascade goes through several steps to automatically create a navigational menu for your templated pages. This is done through a process called "indexing." For the purposes of this tutorial, it isn't necessary to cover how indexing works. We're going to focus on what Cascade looks for when deciding how to create your navigational menu.

Each templated page in Cascade exists inside of a folder (the page's parent folder), and it is within this parent folder that Cascade works to create your menu. Cascade is not concerned with pages or folders that are outside this parent folder.

First, Cascade looks for templated pages in the parent folder. Each page in this folder will be displayed as a top-level navigational link in your menu. In the image below, the selected page is "index." The index page, along with its three siblings, are all listed in the navigational menu as top-level links.

How Navigational Menu Works

Cascade also looks for folders inside of the parent folder. If these folders contain an "index" page, Cascade then looks to see if the pages belong in the navigational menu. The index page is listed as the top-level link, and any of that index page's siblings are placed into the menu directly below the top-level link. These are called subnavigational links. In the image below, there are several folders, each with an index and sibling pages. Notice how the index page (designated in red) is the top-level link, with each of its siblings listed as smaller subnavigational links.

Navigational Works

Here is an example of an index page that exists alongside other folders, each with their own index page (and in the case of folder4, the index page's siblings). The navigational menu links on the right are designated with a matching color over in the file list on the left.

Navigational Works

Now that you've learned the basics, you probably have a few questions. 

How does Cascade determine the text used for a navigational link?

Cascade uses the Title of your page to determine the link text. See the image below the next question for an example.

How can I tell Cascade that I don't want a page included as a top-level or subnavigational link?

There are two sets of radio buttons right below the Title field that control whether or not a page shows up in your navigational menu. "Display in Navigation" is the master control and is a required field; if you select "No," the page will not show up in your navigation as either a top-level or subnavigational link. If you select "Yes," you then have the option to allow the page to show up (where appropriate) as a subnavigational link. See the image below for an example.

Display in Subnavigation

How does Cascade determine the order in which the navigational links are displayed?

Every asset in Cascade, whether it is a page, a file, a folder, or anything else, has an "Order" value associated with it. Cascade uses this value to determine the order of the links in the navigational menu. To see the Order values for a page's parent folder, click on that folder in the file list.

In the images below, you'll see the contents of a folder displayed in two different ways. The default display order is alphabetical, seen in the first image. Note that the Order value for each item (marked in red) is displayed in the adjacent column. By clicking the "Order" tab at the top of the column, you can sort the folder's contents by Order value (second image; Order is once again marked in red).

Navigational Works


Navigational Works

To change the Order value of an item (and therefore change its position in the menu), simply sort the folder contents by Order and move the item into the desired position.

Or you can use the "Action" keys to move each item into the desired position.

Navigational Works


Navigational Works


Navigational Works


Navigational Works

How do I add a link to an external site?

This is covered in our External Link tutorial.