Links in Word files behaviors
Hello,
I have a word document that contains some links and when I upload it to Brightspace, it gets converted into a PDF file. When looking at the document as a PDF, some of the links the document contains work and some don't… I looked at how the links are setup in Word and can't find any differences or reason why one work and the others don't.
Any thoughts?
Best Answer
-
Hello @Frédéric.C.425,
Thank you for reaching out via the Brightspace Community!
Could you please follow the workflow mentioned by Sarge to resolve this issue? If the issue still persists, please feel free to contact us through a support case so we can investigate further.
Kind regards,
Prithvi Anvekar
Product Support Specialist
D2L Corporation
Answers
-
That’s a really good question — and it’s a common (and frustrating) issue when uploading Word documents with hyperlinks to Brightspace (D2L), which automatically converts them into PDFs.
Here’s a breakdown of why some links stop working and how you can fix it:
⚠️
Why Some Links Don’t Work After Conversion
When Brightspace converts a .docx to a PDF, it uses an automated PDF generator that sometimes mishandles hyperlinks. Common causes include:
- If a link was just typed (like www.google.com) but never converted into a real hyperlink (blue + underlined with clickable metadata), Brightspace’s converter may not recognize it.
- If the hyperlink text wraps to a new line or has hidden formatting, the conversion process can “cut” the URL, breaking the link.
- If the hyperlink display text is different from the actual URL (e.g., “Click here” linked to a long URL), Brightspace sometimes fails to embed it correctly.
- Links like mailto: or local file paths (C:\Documents\...) often don’t translate well in the PDF conversion.
- Certain Word themes, SmartArt, or table styles can block link metadata when converted.
✅
How to Fix It
Try these steps before re-uploading to Brightspace:
- Highlight the link text → Right-click → Link → Insert Link → Paste the URL → OK.
- Avoid copy-pasting from browsers directly into Word; instead, paste the text first, then add the link.
- Make sure the entire link (display text and URL) is on one line in Word.
- Always start links with https:// — not www. or a shortened link.
- Go to File → Save As → PDF → Options → Document structure tags for accessibility → ✔️ checked.
- Upload your own PDF version instead of letting Brightspace convert it.
- Open your saved PDF locally and click every link. If it works in Adobe Reader, it should work in Brightspace.
- Brightspace’s converter often drops hyperlinks attached to non-text objects.

