How to Embed PDF Files as Images in Word XML Documents
Question details
The user needs to embed PDF files as images within Word documents using XML mapping.

- Product
- Microsoft Word
- Device & OS
- Windows and macOS
- Scenario
- Populating document fields automatically with links to PDF files via Word XML mapping.
- Observed behavior
- Word for Mac natively recognizes and maps PDFs as picture formats, but Word for Windows does not support direct PDF-to-picture insertion and requires PDFs to be inserted as objects.
Verify whether your target audience will be viewing the final Word document on a Windows PC or a Mac, as PDF handling varies significantly between the two operating systems.
Insert the PDF as an Object in Word for Windows
Since Word for Windows doesn't support direct PDF-to-image XML mapping, you must insert the PDF manually as an OLE object.
Word for Windows natively restricts inserting PDF files directly as image formats via XML mapping. To embed the PDF content, you must bypass the standard picture mapping and use the Object insertion method instead. Be aware that the document package might not inherently generate a visual preview image of the first page.
Navigate to the 'Insert' tab on the Word ribbon and click on the 'Object' button located in the Text group.
In the Object dialog box, click on the 'Create from File' tab.
Click 'Browse', locate your target PDF file, select it, and click 'OK' to embed it into the document as an object.

Map PDF Files Directly in Word for Mac
Word for Mac natively recognizes PDFs as picture formats, allowing direct XML mapping.
Convert PDF to JPEG Before XML Mapping
To ensure the embedded image displays correctly on both Windows and Mac, convert the PDF to a JPEG file before executing the XML mapping.
Use WPS Office for Seamless Document Management
Dealing with cross-platform XML mapping and PDF embedding issues in Microsoft Word can be frustrating. WPS Office provides a free, lightweight, and highly compatible alternative for your document processing needs, ensuring smooth file handling across different operating systems.
- 1. Download WPS Office: Visit the official WPS website and download the free version for your operating system.
- 2. Open Your Document: Launch WPS Writer and open your existing Word or XML document directly.
- 3. Convert PDFs Easily: Use the built-in PDF tools under the 'Tools' tab to seamlessly convert PDFs to images and insert them into your documents.

Frequently Asked Questions
Why does my embedded PDF show as a file icon instead of an image in Word for Windows?
Word for Windows processes PDFs as OLE objects rather than native images. Unless you explicitly choose to display the object's preview (which may not always render the first page) or convert it to an image format first, it often defaults to showing the generic PDF program icon.
Can I use XML mapping to automatically insert PDF icons in Word?
Yes, you can map links to PDF files using Word XML mapping. However, the rendering depends on the operating system. Word for Mac handles it natively as an image preview, while Word for Windows generally treats it as a linked object.
How do I ensure the first page of my PDF always appears as a preview in Word?
The most reliable method for both Windows and Mac users is to convert the first page of the PDF to a standard image format, such as a JPEG or PNG, and map that specific image file into your Word XML document instead of the raw PDF.
Does WPS Office support inserting PDFs into text documents?
Yes, WPS Office Writer allows you to insert PDFs as file objects into your documents. Additionally, it features excellent built-in tools to convert PDFs to pictures, making it incredibly simple to embed them directly as highly compatible images.




