How do I add an icon and link to popup text?

Modified on Mon, 15 Jun at 4:45 PM

The Icon and Link to Popup Text block allows content creators to pair an icon with a clickable link that, when selected, opens a modal overlay displaying additional text content. Icons are processed faster than plain text, helping learners quickly identify important or recurring concepts. This block is ideal for providing supplemental information, definitions, or expanded details without navigating away from the page—keeping learners focused while making extra content available on demand. Icon titles and link text are read by screen readers, supporting accessibility for keyboard and assistive technology users.


  1. Navigate to the page and select Edit this Page. Find the position you want to add a block and select the plus (+) icon.
    Screenshot of a blank content page in Edit mode.

  2. From the dropdown, select Add Block.
    Screenshot of a pop up menu that prompts users to Add Block, Paste from Clipboard, and Add Boilerplate Template

  3. In the Add Block modal, either:
    • Use the Search field to find a block by keyword
    • Select a block from your custom list of Favorites
    • Scroll through the list of All Blocks to select one
    • Use the various Categories to filter by block type
    • Select a star icon to add or remove blocks in your Favorites listscreenshot of add block with the icon and text block showing

  4. Select the Icon and Link to Popup Text block. The Add Icon and Link to Popup Text form will open. Select the Select an icon field.
    icon and pop up text blank form
  5. The File Manager will appear, displaying the icons associated with the course. Select the checkbox for the desired icon.
    file manager showing the course icons
  6. The Add Icon and Link to Popup Text form will reappear with the chosen icon. Complete the link and popup text fields and then select Add Block+.
    icon and link to popup text with the icon selected and link and text fields complete 
  7. The new block will appear on the page in Edit Mode with a red, dotted outline indicating it's editable.
    icon and pop up text block in edit mode

  8. Select the Publish My Edits button to save the block to the course page and see the content as it will appear to learners.
    icon and popup text block published on the page
    sample icon and link to popup in the published view


Default Text

Each icon can be configured with default starter text, allowing administrators to establish consistent language across icons. This default text can be customized by users with the System Administrator or Graphic Designer global role.


System Administrators and Graphic Designers, refer to How do I create an icon set? for more information on how to set up this feature.
sample default text for a reading icon

Example of default starter text for a reading icon.


sample default text for a video icon

Example of default starter text for a video icon.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article