SharePoint Document Issues

Display an Image When Hovering Over a SharePoint Hyperlink

Huma Ashraf ChHuma Ashraf Ch Nov 4, 2026 870 views

Question details

The user wants to display an image preview instead of a standard text description when the mouse pointer hovers over a hyperlink in a SharePoint Wiki site.

Display an Image When Hovering Over a SharePoint Hyperlink
Product
Microsoft SharePoint
Device & OS
not provided
Scenario
Customizing hyperlinks on a SharePoint Wiki page to show a visual image preview (similar to Wikipedia) upon hover.
Observed behavior
SharePoint currently displays default file hover cards or standard text tooltips, lacking a built-in feature to manually set custom hover images for Wiki links.
Before you start

Verify whether you are using a classic SharePoint Wiki site or a modern SharePoint site page, as native capabilities and available workarounds differ between the two interfaces.

Solution 1Recommended

Understand SharePoint Hover Card Limitations

Learn about the default behavior of SharePoint Wiki links and why manual image hover previews are unsupported out-of-the-box.

SharePoint Wiki hyperlinks do not natively support displaying custom images when hovering over text links. The system is designed to show either standard text tooltips or predefined file hover cards.

File hover cards automatically extract metadata and document previews for files stored in document libraries. However, these hover cards cannot be manually modified to show a distinct custom picture instead of the default text or system-generated preview.

1
Observe default behavior

Hover your mouse pointer over an existing hyperlink in your SharePoint Wiki. Notice that standard text links display a simple text tooltip based on the hyperlink's title attribute.

2
Check document links

Hover over a direct link to an Office document or supported image file within SharePoint. You will see an auto-generated file hover card displaying system details and an automatic thumbnail, which cannot be customized manually.

System Limitation: Because this is a core architectural restriction in SharePoint's native web parts, no standard setting or menu option can force a Wikipedia-style custom image hover preview.
Free Microsoft Office alternative

Enhance Your Document Workflow with WPS Office

While SharePoint handles site-level linking and web parts, WPS Office provides a powerful, free, and lightweight solution for creating and editing the actual documents you share on your intranet. With a familiar interface and robust feature set, transitioning to WPS Office is completely seamless.

Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx)Lightweight application that runs flawlessly on older or lower-spec devicesHighly familiar tabbed interface requiring zero learning curve for traditional Office usersBuilt-in PDF editing, conversion, and annotation tools at no extra cost
microsoft office alternative - wps office

Frequently Asked Questions

Can I use custom code to add an image hover effect in SharePoint?

Yes, but not natively. Modern SharePoint heavily restricts custom CSS or JavaScript injections for security reasons. Developers must build a custom SharePoint Framework (SPFx) web part to implement advanced interactive elements like image hover effects.

Why do some SharePoint links show a preview card while others don't?

SharePoint automatically generates file hover cards with document previews when linking directly to supported files (such as Word documents, PDFs, or images) stored within a document library. Standard hyperlinks pointing to external websites or Wiki pages do not trigger these visual previews.

Are classic SharePoint Wiki sites being phased out?

Yes, Microsoft heavily prioritizes modern SharePoint Site Pages over classic Wiki sites. Modern pages offer better mobile responsiveness and richer web parts, though native text-to-image hover customization remains unsupported in both.