References

Overview

A reference is a special asset in Cascade CMS that represents an existing asset in another location; thus, a single asset can appear to exist in multiple locations. While a single asset appears in navigation as if it were in multiple locations, in actuality, it directs back to the original asset.

The reference, when indexed by an index block, will render content for the linked-to asset. Deleting the reference will have no effect on the referenced asset.

References are a great way of creating index block renders, as users can create a folder of explicitly-chosen content that can be quickly indexed by an index block that is set to render the references in the folder.

References are often used to display links in navigation menus in other folders than where the page actually resides.

Creating a Reference

To create a reference:

  1. Right-click on the asset to be referenced and select Reference from the context menu. Alternatively, click More > Reference while viewing the asset in question.
  2. Select a Name for the reference. Note that the Title and Display Name for the reference will be pulled from the original asset being referenced.
  3. Select a Placement Folder for the reference.
  4. Click Submit.