Self-Help Guides: Add a Link to a Resource on Another Website

Columns in a self-help guide are made up of Main Categories, Sub-categories and resource links. For more information on the structure of a self-help guide, see: Understand the Structure.

When creating links in the self-help guide, you must enter a Title and URL for each document you wish to make available to you users. There are some additional fields, as well, that control what icon appears in front of the URL and whether the link will open in a new window.

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


  1. Click Content in the Administrator Toolbar.
  2. Search for the Self-help Guide Column you want to update, and click Edit.
  3. Click Links in the Subcategory where you want to add a link. The list of links for that subcategory will open.
    A screenshot showing the Links dropdown follows the subcategory description field
  4. If all Link fields are used, click the Add another item button below the last link.
  5. Enter a title for the link in the Title field.
  6. Enter the URL to the link in the URL field.
  7. Select Read or Watch from the Read/Watch field. 
    • Note: This field controls the icon that appears before the link.
  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.
  10. (Optional) Add keywords in the Filter Keyword field. 
    • Note: These keywords will help to surface the link when a visitor uses the Self-Help Guide filter*.
  11. (Optional) Enter an internal page to be used as keywords for the Self-Help Guide filter* in the Associate resource page field (implemented for OIT only). 
  12. Save or Publish the column.
    • Note: The options you see for saving and/or publishing the column will depend on how your site is set up.

Drupal editor screen for adding links in the self-help guide

*The Self-Help Guide filter functionality is currently not available. It may be added to the module at a later time.