KB User's Guide - Advanced HTML - Create a list of featured links

Add a group of links in a two column card-style layout within the flow of your document or as their own content module on a custom homepage.

4 white and slim cards with a light drop shadow displayed side by side

Overview

Cards will display in two columns on desktop and one column on mobile devices. There are a few different ways to customize this element.

  1. Add icons to convey meaning, and change their color
    1. Learn how to use icons and find resources for icon libraries
  2. Or don't add icons for a more minimal look
  3. Display a UW minibar (short red line) above the header of a group of featured links
    1. Note: This minibar will only display if you use the Homepage Layout V2 as a custom homepage. 

Don't do this

This page element is not intended for KB sites that use a two or three column layout, because they will not display side-by-side as intended:

Each featured link if used within a KB User's Guide document today on February 25 2023 would display as one column on desktop sites rather than two, which is not recommended

Do not use this page element if you use the Standard / Subpage Layout settings for your homepage design. The styling will not work.

Featured links page element if used on the KB User's Guide today on February 25 2023 would not display the proper amount of padding so content and icons look smooshed together

Do this

Use a one column layout for your site with no left or right side modules applied. You can accomplish by...

  • Use the standard layout settings with a 100% width applied for your homepage and subpages 
  • Do the above, but also use a custom KB template for your homepage rather than the standard settings 

Update your site's standard settings to a one column layout...

  • Navigate to Settings, and then Site Layouts
  • Set your Standard / Subpage Layout to use Relative Width (100% up to 3 columns) as the layout
  • Go to Side Modules in the left hand sidebar
  • Remove any side modules on the Side Right or Side Left position
  • Click Update to save changes

Apply a custom KB layout as your homepage...

  • Under the Settings tab and Site Layouts, open the Custom Homepage panel 
  • Select Homepage Layout V2 as your layout
  • Click Update to save changes
  • Learn how to design your site using Homepage Layout V2

  1. The first image shows how this page element appears on a KB site using the Homepage Layout V2 template.
  2. The second image shows how this page element appears on a document when a site's standard layout settings are set to one column with no left and right side modules.

Add featured links to a document

Open the code view of the WYSIWYG editor.

Code editor view in the WYSIWG toolbar is indicated by two left and right chevron symbols

Copy the code from the HTML tab below into the code editor:

See the Pen Featured links with icons by WPS Client Engagement (@clientengagement) on CodePen.

Scroll down to the bottom of the page and open the Show Additional Fields panel. Add an opening and closing style tag into the JavaScript/CSS field:

<style> </style>

Copy the CSS from the CSS tab from the embedded Codepen above and paste it in between the two style tags. 

Click Submit to save your changes. 

Start with no icons

If you'd like to start with no icons, use the following HTML and CSS using the instructions above. 

See the Pen Featured links - No icons by WPS Client Engagement (@clientengagement) on CodePen.

Add your own icons 

Upload your icons into the document's attachment folder, and then change the URL path to your image in the CSS under the background-image property.

Add featured links to your homepage with a custom content module

First, create a new document and complete the steps in Add featured links to a document. Note your document ID to use in a later step. You can find the ID at the top of the page. It will read similar to “Editing Document 123456.”

Navigate to the Settings tab and click on Content Modules in the left hand sidebar. 

Under the header Add a custom content module you will

  • include a module name, which will display as the header of your section.
  • select whether to display on your internal or external site. 
  • select FullView and MobileView to display both on desktop and mobile devices. 
  • if you have more than one content module on the page, choose the order in which you want this section to appear on your homepage.
  • add the ID of the document you just created. 
  • click Add, and then Update at the bottom of the screen.

Design guidelines

Now that you have a starter template for featured links, you can customize the content and styling.

Edit the content to reflect what’s most important to your users. Some helpful tips to get started...

  • Leverage Google Analytics data to understand how users engaged with your documents.
    • What documents do they visit most often? Are those documents helpful?
    • Can the documents they visit most be grouped into similar categories?
  • Within the KB dashboard under the Stats tab, click on Top searches in the left hand sidebar to see what people search for most on your site.
    • Does your site have documents that supports what they want to find?
    • Do you notice anything unusual?
  • What questions do my users ask when they reach out? Where do they tend to get confused and ask for help?

Don't do this

This page element should not...

  1. exceed six links 
  2. use an odd number of links
  3. display only one link item
  4. use a mixture of no icons and icons; commit to either one or the other for each section where this page element is used
  5. use more than one color for icons or colors that do not meet UW brand and accessibility guidelines
  6. use icons from different icons packs

More about icons 

Color

We recommend only using UW's blue, red, or body font color for icon colors. Visit University Marketing's web colors guidance to learn more.

When not to use icons

Icons should only be used when they communicate meaning related to its associated content, not just for visual aesthetics. If it takes longer that 5 minutes to think of an appropriate icon, don't use them because it's likely a use case where icons won't provide effective meaning. 

Icon libraries

    DoIT Communications has created an icon pack usable by campus for their websites. You must log in to Box to access these files. 

    For more icons or non–UW sites, we recommend Material Icons which are open source and can be used without cost. Use the SVG file type with Material Icons for best image quality or if you want to change the icon color. If using the PNG file type, download an icon size that's at least 48px by 48px. 



    Keywords:
    featured links group two column side by side cards page element component elements components 
    Doc ID:
    124322
    Owned by:
    Leah S. in KB User's Guide
    Created:
    2023-02-24
    Updated:
    2024-08-20
    Sites:
    KB User's Guide