Self-Help Guides: Work with Links to Resources

In Drupal Enterprise use links to direct readers to content such as How-Tos, Comparison Pages, Good Practices, and other resources. Links may go to outside resources or resources from within the same site.

Note: These instructions assume you have logged into your Drupal site and that you have permissions to edit content in the site.

Adding a Link to a Resource on Another Website

You can add a link to a resource within the Self-Help guide by entering a URL.

  1. Go to the Self-Help Guide Page you wish to edit. 
  2. Find the Subcategory you wish to add a link to.
  3. Select Add Guide Link.
  4. Enter the URL to the link in the URL field.
  5. Enter a link title in the Link text field.
  6. Select Read or Watch from the Read/Watch dropdown. 
    • Note: This field determines the icon that appears next to the link.
  7. (Optional) Select a Resource Type from the dropdown.
  8. (Optional) Write a short description of the link in the Link Notes field.
  9. Leave the box un-checked in front of Display full body text for internal links.
    • Note: This feature is not available for links to resources on another website.
  10. Save or Publish the page.
    • Note: The options you see for saving and/or publishing the column will depend on how your site is set up.

Adding a Link to a Resource on the Same Website as the Self-Help Guide

You can link to resources contained in the same site as your self-help guide using the resource's title or node.

  1. Go to the Self-Help Guide Page you wish to edit. 
  2. Find the Subcategory you wish to add a link to.
  3. Select Add Guide Link.
  4. Enter a title for the link in the Link Text field.
  5. Start typing the title of the internal webpage or content and Drupal will generate a list of matching pages that you can pick from.
  6. Select Read or Watch from the Read/Watch dropdown. 
    • Note: This field determines the icon that appears next to the link.
  7. (Optional) Select a Resource Type from the dropdown.
    • Note: If you are providing a number of links in a subcategory, it can be helpful to your users to have the links grouped in categories.
  8. (Optional) Write a short description of the link in the Link Notes field.
    • Note: The description will display below the link.
  9. (Optional) Check the box next to Display full body text for internal link if you would like the text of the linked webpage to display inline in the self-help guide.
    • Notes:
      • An effective use of a single-column self-help guide is to display the step-by-step instructions inline instead of as a linked resource. Displaying content inline is only recommended for single-column self-help guides.
      • Only links to pages in the same website as the Self-help Guide that are created using the General page content type can be displayed inline.
      • In a subcategory where you have chosen to display inline content, no other links to resources can be displayed. Only the page displayed inline will be visible.
        Single column self-help guide example with a main category and two subcategories. One subcategory is expanded, revealing how-to instructions.
  10. Save or Publish the page.

Reordering Links in a Subcategory

  1. Click and hold the Move icon  next to the link you wish to reorder.
  2. Drag the link up or down to place the link where you want to place it. 
    • Note: You can only reorder a link within the same subcategory.

Deleting a Guide Link to a Resource

  1. Select the three dots to the right of the Subcategory you wish to delete and select Remove.
    Druapl 8 self-help guide page, guide link section. Three dots highlighted and expanded, remove highlighted.
  2. Save or Publish the page.

Last modified

TDX ID

5966