Category 4: Descriptive Text for Links
Descriptive links are used instead of placing a webpage URL directly in your content. The Canvas Rich Content Editor (RCE) allows you to create descriptive text links easily. Follow the steps in this guide to ensure your links make sense to students and are accurately read by assistive technology.
- Navigate to a Canvas course to add the descriptive text link.
- Use the RCE to type the descriptive text that you want to see.
- Highlight the text you just typed.
- Look for the Link icon in the toolbar.
- In the External Link field, paste the URL of the web page you want to link to.
- Click the Done button to insert the link into your text.
- Save your changes.
- Review your new descriptive text link to ensure it looks and functions as intended.
Need more detail?
Delve into the in-depth walkthrough below, complete with images and various notes for every step.
In-Depth Walkthrough
Step 1
Log in to your Canvas account and navigate to the course, page, or assignment where you want to add the descriptive text link.
Step 2
Click on the "Edit" button of the space you want to work on to open the Rich Content Editor. Use the RCE to type the descriptive text that you want to see. Your descriptive text should be a concise and clearly indicate the content being linked. Avoid making your link more than 3-5 words or using vague references like "click here" or "visit this page to learn more".
![](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1MzMwODQsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.k9LiJr9UjxXYUP-HQS-y4TRZ3GTcAj9Yrn5fUIVJY1U)
![](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1MzMxMDYsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.nBkrWVCTYAzDpgrTHrZMXsFXURlXbGVB_6qSl9u9F14)
Step 3
Highlight the text you just typed by clicking and dragging your cursor over it.
![DELETE](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1NzQyNzgsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.eDfBpYDhbhdY12jM5zerkTvEGcZIID_yrayNCT5qVFQ)
Step 4
Look for the Link icon in the toolbar that looks like a chain link. Alternatively, you can click the Insert option to select Link, then External Link.
- The External Link option is used to link to content outside your Canvas course.
- The Course Link option is used to link to an area within your Canvas course.
![](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1NzM2OTAsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.xLg5MklSPAy6RCu1AdXGAyjL072sxIgj4eanuF8A-BY)
Step 5
In the External Link field, paste the URL of the webpage you want to link to. Make sure it starts with "http://" or "https://".
![](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1MzMxNDksImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.DsQ4QJhdt5AAbJmjhhHN0C7J7OKAnT3mlsnTnOz7Q14)
Step 6
Click the Done button to insert the link into your text. You will see the link is live because the text will be blue and underlined.
![DELETE](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1NzQzNjUsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.QBE0nQVjhjHnYnxrzEz-8GL6rZdzzKnNipHHVK_k7Dc)
Step 7
Click the Save or Save and Publish button at the bottom of the page to save your changes. The linked text displays in red once you save.
![DELETE](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1NzQ4MTksImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.TmeFiy8fps_zA653i0JMkKWPGINwROyvFvVM2FYRasY)
Step 8
Review your new descriptive text link to ensure it looks and functions as intended. As web content frequently changes, there is also a validate links in content tool in your course Settings to help you ensure links are still functional each term.
![](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNTQ1NzQ4NzAsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0.8zQGm4Kk9TbiANIkOGo7yh-W3C0E_wcSW8-qBTwNp88)
FAQ
How do descriptive links help someone with disabilities?
For users with visual impairments who rely on screen readers, descriptive links are crucial. Screen readers often read out a list of links on a page, and non-descriptive links like "click here" or "read more" provide no context, making it difficult for these users to navigate effectively. Full URLs pasted in the text are read as is, which is overwhelming to listen to. Descriptive links ensure that the purpose of each link is clear when read by assistive technology.
Do descriptive links help people without disabilities?
Yes. Descriptive links provide clear information about the destination or content behind the link, reducing ambiguity and helping users understand what to expect when they click on it. When users encounter non-descriptive links, they often have to read surrounding text to understand the link's context, which increases cognitive load. Descriptive links reduce this need, allowing users to make quicker decisions and navigate more efficiently.
![For tech help call 210 829 2721 or email helpdesk@uiwtx.edu](https://attachment.freshservice.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MTcwNDYyMzczNjIsImRvbWFpbiI6InVpdy5mcmVzaHNlcnZpY2UuY29tIiwidHlwZSI6MX0._bn8gOIB-VCnSyCTPVODDQgVL1Nvxlqwc5d60yA8tfw)