Embedding Hyperlinks to CMS Channels, Content, and Static Files

Sometimes it is helpful to make use of embedded links to navigate to content or channels within a site already in the CMS. This is possible anywhere the editing toolbar is present through the Insert VCM function found under the Insert Menu and serves two primary benefits:

  • You can prepare an ICE version to other ICE channels and content before the referenced pages are made live.
  • If someone changes the location of referenced channels or content and thus changes their URLs, the VCM will track the change and adjust properly keeping the link from being broken.

Linking to Channels

It may be necessary, at times, to link to other areas of your site or another page or site outside of your own but still within the CMS.

  1. Link Destination – describes the type of link you are creating; in this instance, a Channel within the CMS
  2. Link Text – words in the body field that will become the clickable link
  3. Alternate Text – words that will be read aloud by a screen reader used for accessibility purposes
  4. Channel – select browse to look at a folder listing much like the AppConsole and select the desired channel
  5. Open in New Window – when checked will open the destination provided by the external URL in a new browser window. This practice is discouraged as screen readers for visually impaired visitors will not always announce the new window.

Content Instance

This option allows you to link to any content in the CMS.

  1. Link Destination – describes the type of link you are creating; in this instance, a Content Instance in the CMS
  2. Link Text – words in the body field that will become the clickable link
  3. Alternate Text – words that will be read aloud by a screen reader used for accessibility purposes
    Content Instance – you may Find and link to any content instance within the CMS or create a new
    content item to link to
  4. Select a Channel – if a piece of content is used in multiple channels, enables you to choose which “place” you are referencing; also available: “Use first Channel on current site”
  5. Context Channel – channel selection list referenced above
  6. Format – leave set to “default”
  7. Open in New Window – when checked will open the destination provided by the external URL in a new browser window. This practice is discouraged as screen readers for visually impaired visitors will not always announce the new window.

Static File

If you need to reference a non-image, static file (.pdf, .doc, etc.), use this option to link directly to the static file instead of a content instance containing a static file.

  1. Link Destination – describes the type of link you are creating; in this instance, a Static File within the CMS
  2. Link Text – words in the body field that will become the clickable link
  3. Alternate Text – words that will be read aloud by a screen reader used for accessibility purposes
  4. Static File  – select browse to look at a folder listing much like the AppConsole and select the desired static file or upload a new static file
  5. Open in New Window – when checked will open the destination provided by the external URL in a new browser window. This practice is discouraged as screen readers for visually impaired visitors will not always announce the new window.