How to embed pdf in word using GroupDocs.Merger for Java

Embedding a PDF directly inside a Word document can dramatically improve collaboration, because readers no longer need to switch between files. In this guide you’ll discover how to embed pdf in word documents using GroupDocs.Merger for Java, and see practical tips on add pdf to word workflows. We’ll walk through everything from setting up the library to customizing the size and placement of the OLE object, so you can automate document creation with confidence.

Quick Answers

What library is required? GroupDocs.Merger for Java (latest version)
Can I embed any file type? Yes – PDFs, images, spreadsheets, etc., as OLE objects
Do I need a license? A free trial works for development; a commercial license is required for production
Which Java IDE works best? IntelliJ IDEA, Eclipse, or any IDE that supports Maven/Gradle
How long does the implementation take? Roughly 10‑15 minutes for a basic embed

What is embed pdf in word?

Embedding a PDF creates an OLE (Object Linking and Embedding) object inside the Word file, allowing the PDF to be opened directly from the document. The embedded file retains its original formatting and interactivity, while the Word document remains a single, self‑contained package. This approach simplifies distribution, ensures version consistency, and provides readers with instant access to supplemental material without leaving the Word environment.

Why add pdf to word using GroupDocs.Merger?

Using GroupDocs.Merger to embed PDFs gives you a programmatic, repeatable way to combine documents without manual editing. The library handles OLE insertion, size adjustment, and positioning automatically, which saves time and reduces human error. It also supports batch processing, so you can embed dozens of PDFs across multiple Word files in a single run, making it ideal for large‑scale documentation, contracts, or marketing kits.

Prerequisites

Libraries & Dependencies: Include the GroupDocs.Merger library via Maven or Gradle.
Development Environment: IntelliJ IDEA, Eclipse, or any Java IDE.
Basic Knowledge: Familiarity with Java and document manipulation concepts.

How do I set up GroupDocs.Merger for Java?

First, add the GroupDocs.Merger library to your project using the build tool of your choice. The library provides all the classes you need for OLE handling, including Merger, OleWordProcessingOptions, and related utilities. After the dependency is resolved, you can start creating Merger instances and work with Word documents programmatically.

Maven

Add this dependency to your pom.xml file:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

Include this in your build.gradle file:

implementation 'com.groupdocs:groupdocs-merger:latest-version'

Direct Download

Alternatively, download the latest version from the GroupDocs.Merger for Java releases page.

License Acquisition: You can start with a free trial or obtain a temporary license to evaluate features before purchasing. Visit Purchase GroupDocs for more details.

How does the basic initialization work?

The Merger class is the entry point for all document‑processing operations in GroupDocs.Merger for Java. After you create a Merger instance, you can call methods such as importDocument to embed OLE objects. Import the required classes so you can work with OLE objects:

import com.groupdocs.merger.Merger;
import com.groupdocs.merger.domain.options.OleWordProcessingOptions;

How can I embed a PDF into a Word document step‑by‑step?

Embedding a PDF involves loading the source Word file, specifying the PDF path, configuring visual options, and finally calling the importDocument method to insert the OLE object. The importDocument method takes the source document, the file to embed, and an OleWordProcessingOptions instance that defines size, alignment, and display mode. This sequence ensures the PDF appears exactly where you need it with the desired appearance.

Step 1: Define file paths and target page

Set the source Word document, the PDF you want to embed, and where the OLE object should appear.

String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx"; // Source Word document path
String embeddedFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf"; // File to be embedded as an OLE object
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY",
    "ImportDocumentToWordProcessing-" + Paths.get(sourceFilePath).getFileName().toString()).getPath();
int pageNumber = 2; // Page number where the OLE object will be inserted

sourceFilePath – path to the existing Word file.
embeddedFilePath – the PDF you want to add pdf to word.
outputFilePath – where the new document will be saved.
pageNumber – the page that will host the OLE object.

Step 2: Configure OleWordProcessingOptions

The OleWordProcessingOptions class defines how the OLE object looks inside the Word document. You can set width, height, alignment, and even a caption.

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Set width of the embedded object (in points)
oleWordsOptions.setHeight(300); // Set height of the embedded object (in points)

setWidth() / setHeight() – control how large the PDF icon appears inside the Word document.

Step 3: Initialize Merger and import the OLE object

Create a Merger instance for the source document, import the OLE object, and save the result.

Merger merger = new Merger(sourceFilePath);
{
    merger.importDocument(oleWordsOptions); // Embed the OLE object into the Word document
    merger.save(outputFilePath); // Save changes to a new output file
}

importDocument() – takes the OleWordProcessingOptions and inserts the PDF as an OLE object.
save() – writes the modified document to outputFilePath.

Step 4: (Optional) Re‑apply configuration for additional objects

If you need to embed more PDFs, repeat Step 1‑3 with new file paths and page numbers. The same OleWordProcessingOptions class lets you control each object individually.

How can I configure OleWordProcessingOptions for advanced scenarios?

OleWordProcessingOptions is the configuration hub for OLE embedding. You can align the object to the left, center, or right, add a caption underneath, and even specify whether the embedded file should be displayed as an icon or as a preview. The code snippet below repeats the basic configuration for clarity:

OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions(embeddedFilePath, pageNumber);
oleWordsOptions.setWidth(300); // Width of the embedded object
oleWordsOptions.setHeight(300); // Height of the embedded object

What are practical applications of embedding PDFs in Word?

Embedding PDFs is valuable in many professional contexts because it keeps related content together while preserving the original formatting of each file. For example, technical manuals can include detailed schematics, financial reports can attach audit statements, legal contracts can embed annexes, and marketing brochures can incorporate product spec sheets—all without requiring separate downloads or external links.

How do performance considerations affect large documents?

When processing large Word files or multiple OLE objects, it’s important to manage memory and I/O efficiently. Trim unnecessary content, embed only required pages, and allocate sufficient JVM heap space using the -Xmx flag. Additionally, keep the GroupDocs.Merger library up‑to‑date, as newer releases often contain performance improvements that reduce processing time and memory consumption for documents with many embedded PDFs.

What common issues might I encounter and how do I solve them?

Typical problems include incorrect file paths, out‑of‑memory errors, corrupted source PDFs, and missing OLE icons. Ensure that both Word and PDF paths are absolute or correctly relative to the project root, increase the JVM heap size for large batches, verify that each PDF opens normally before embedding, and confirm that the target Word template allows OLE insertion. Adjusting these factors usually resolves most embedding failures.

Frequently Asked Questions

Q: What is OLE embedding?
A: Embedding allows you to insert objects like PDFs into Word documents as links that maintain their original functionality.

Q: Can I embed multiple OLE objects in one document?
A: Yes, each can be configured for different pages and sizes using separate OleWordProcessingOptions.

Q: Is there a limit on the size of embedded files?
A: The limit is generally dictated by Word’s own constraints, but GroupDocs.Merger handles large files efficiently.

Q: How do I resolve embedding errors?
A: Verify that file paths are correct and that the JVM has enough memory. Check that the source PDF isn’t corrupted.

Q: Can I modify embedded objects after insertion?
A: You can reopen the Word file in Microsoft Word and edit the OLE object, or re‑run the Merger code with updated options.

Additional Resources

Last Updated: 2026-06-21
Tested With: GroupDocs.Merger for Java latest version
Author: GroupDocs