Full Working Example to Combine Multiple Word Documents in Java

This example demonstrates how to combine multiple Word documents in Java using the Merger API.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

        try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

            // Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

            // Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

            System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update any file paths and configuration values to match your actual environment, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Merge Word Files via REST API Using cURL

If you prefer a pure REST approach, the same merge operation can be performed with cURL calls. The steps below show how to obtain an access token, upload source files, request the merge, and download the result.

Authenticate and obtain an access token:

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Upload each DOCX file to your cloud storage (replace YOUR_ACCESS_TOKEN with the token from the previous step):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

Repeat the upload command for input2.docx and input3.docx.

Create the merge request:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

Download the merged document:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

For more details on request parameters, see the official API documentation.

Understanding the Process of Combining Word Documents in Java

Below is a step‑by‑step breakdown of the code shown earlier.

1. Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") establishes a connection to the GroupDocs cloud service.

   ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
   

2. Instantiate MergerApi - new MergerApi(apiClient) gives access to merge‑related endpoints.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Prepare source file list - Each FileInfo object points to a DOCX file stored in the cloud. The list is passed to MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Configure MergeOptions - Set the desired output path and attach the list of source files.

   MergeOptions mergeOptions = new MergeOptions();
   mergeOptions.setOutputPath("merged_output.docx");
   mergeOptions.setFileInfos(sourceFiles);
   

5. Execute merge - mergerApi.merge(mergeOptions) sends the request and returns a FileInfo for the merged document.

   FileInfo result = mergerApi.merge(mergeOptions);
   

For a full list of available properties, refer to the API reference.

Prerequisites and Setup for GroupDocs.Merger Cloud SDK

Before you can run the code, add the Maven dependency to your project and ensure you have a valid GroupDocs account.

Add the SDK to your pom.xml:

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

Download the latest JARs and source from the download page.
You will also need Java 8 or higher and internet access for the cloud calls.
Create a GroupDocs account, obtain your Client ID and Client Secret, and keep them secure.

Conclusion

Merging DOCX files programmatically is now straightforward with the GroupDocs.Merger Cloud SDK for Java. The example code and cURL snippets illustrate two flexible ways to combine multiple Word documents in Java, whether you prefer a native library or direct REST calls. Remember to configure your credentials, handle large files by streaming if needed, and test the merge operation with representative documents. For production deployments you will need a paid license; pricing details are available on the product page and you can request a temporary license for evaluation from the temporary license page.

FAQs

• How do I combine multiple Word documents in Java without writing custom file‑handling code?
  Use the GroupDocs.Merger Cloud SDK for Java. The SDK abstracts all low‑level operations and lets you merge DOCX files with a few API calls.

• Is it possible to merge documents that are stored in different cloud folders?
  Yes. Provide the full cloud file paths in the FileInfo objects, and the merge operation will fetch each file from its location before combining them.

• What should I do if the merge fails with an ApiException?
  Check the exception message for details such as missing files or permission issues. Ensure the file paths are correct and that your account has read/write access to the storage. Consult the official documentation for error codes.

• Do I need a separate license for each environment (development, staging, production)?
  A single license covers all environments, but you must respect the usage limits defined in your license agreement. For testing you can use the temporary license linked above.

Read More

• Password-Protect ZIP File using Password Protection Software
• Password-Protect Excel using Password Protection Service
• Combine Word Documents in C#

What PowerPoint Automation in C# Requires

Enterprises often generate slide decks from templates where titles, subtitles, or data fields need to be updated automatically. The requirements for a robust solution include:

• Ability to locate and replace specific text strings inside PPTX files.
• Support for cloud‑based processing so the code runs on any server without installing Office.
• Clear error handling and easy configuration of input and output paths.

Manual editing or using generic file‑system scripts cannot guarantee consistency across dozens of presentations, especially when the content changes frequently.

The Approach: Cloud‑Based PowerPoint Editing

GroupDocs.Editor Cloud SDK for .NET addresses these needs with a REST‑driven API that works entirely in the cloud. Key capabilities include:

• EditDocument - Replace text, images, or shapes in PPTX files without downloading the whole document.
• FileInfo - Specify source files stored in GroupDocs Cloud storage.
• EditDocumentOptions - Define output location and a list of text replacements.

The SDK handles authentication, file streaming, and format‑preserving edits, allowing you to focus on business logic. Detailed documentation is available at the official documentation.

Implementing edit PowerPoint Presentations in C# with GroupDocs.Editor Cloud

Below is a step‑by‑step walkthrough. Each step includes a short code excerpt taken directly from the full example.

Install the SDK and Add the NuGet Package

First, add the library to your project.

dotnet add package GroupDocs.editor-Cloud

You can also download the latest release from the download page.

Configure API Credentials

Create a Configuration object with your client ID and secret.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

The Configuration class is described in the API reference.

Initialize the Editor API

Instantiate EditorApi using the configuration.

var editorApi = new EditorApi(config);

This object provides all editing operations.

Define Editing Options (Replace Placeholder Texts)

Set the source file, output path, and the text replacements you need.

var editOptions = new EditDocumentOptions
{
    FileInfo = new FileInfo { FilePath = "sample.pptx" },
    OutputPath = "sample_edited.pptx",
    EditTexts = new List<EditText>
    {
        new EditText { Text = "OldTitle", NewText = "New Title" },
        new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
    }
};

The EditTexts collection lets you replace any number of placeholders in one call.

Execute the Edit Operation and Handle the Response

Create the request and call EditDocument.

var request = new EditDocumentRequest(editOptions);
var response = editorApi.EditDocument(request);
Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");

The response contains the path to the edited file in cloud storage.

Complete Code Example: edit PowerPoint Presentations in C# - Full Workflow

The following code demonstrates the entire process from start to finish.

using System;
using System.Collections.Generic;
using GroupDocs.Editor.Cloud.Sdk.Api;
using GroupDocs.Editor.Cloud.Sdk.Client;
using GroupDocs.Editor.Cloud.Sdk.Model;
using GroupDocs.Editor.Cloud.Sdk.Model.Requests;

namespace GroupDocsEditorDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configure API credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

            // Initialize the Editor API
            var editorApi = new EditorApi(config);

            // Define input and output PowerPoint files
            string inputFilePath = "sample.pptx";
            string outputFilePath = "sample_edited.pptx";

            // Set up editing options (replace placeholder texts)
            var editOptions = new EditDocumentOptions
            {
                FileInfo = new FileInfo { FilePath = inputFilePath },
                OutputPath = outputFilePath,
                EditTexts = new List<EditText>
                {
                    new EditText { Text = "OldTitle", NewText = "New Title" },
                    new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
                }
            };

            // Create the request
            var request = new EditDocumentRequest(editOptions);

            try
            {
                // Perform the edit operation
                var response = editorApi.EditDocument(request);
                Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error ({apiEx.ErrorCode}): {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update any file paths and configuration values to match your actual environment, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

PowerPoint Editing with cURL and the REST API

If you prefer a language‑agnostic approach, you can perform the same edit operation with cURL calls.

1. Authenticate and obtain an access token

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Upload the source PPTX file

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload/sample.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.pptx"

3. Execute the edit operation

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.pptx" },
           "outputPath": "sample_edited.pptx",
           "editTexts": [
               { "text": "OldTitle", "newText": "New Title" },
               { "text": "OldSubtitle", "newText": "Updated Subtitle" }
           ]
         }'

4. Download the edited PPTX file

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download/sample_edited.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample_edited.pptx

For more details on request payloads, see the API reference.

Fine‑Tuning PowerPoint Editing Options

The SDK offers additional parameters you can adjust:

• OutputPath - Choose a different folder or file name for the edited presentation.
• EditTexts - Add as many EditText objects as needed to replace multiple placeholders.
• FileInfo.StorageName - Specify a custom storage location if you use multiple cloud storages.

These options are part of the EditDocumentOptions class referenced in the API reference.

Conclusion

Editing PowerPoint presentations in C# becomes straightforward with the GroupDocs.Editor Cloud SDK for .NET. The library handles authentication, file management, and text replacement, letting you focus on business logic. Remember to obtain a proper license for production use; you can start with a temporary license from the temporary license page. With the code sample and cURL workflow provided, you’re ready to integrate dynamic slide editing into any .NET application.

FAQs

How do I edit Powerpoint presentations in C# using GroupDocs.Editor Cloud?
Use the EditDocument method after configuring EditDocumentOptions with your source file, output path, and a list of EditText replacements. The full example is shown earlier in this guide.

Can I replace multiple placeholders in a single PowerPoint file?
Yes. Populate the EditTexts collection with as many EditText objects as required; the SDK will process all replacements in one request.

What should I do if the edited file is not generated?
Check that OutputPath is correctly set and that the API response contains a valid Path. Also verify your credentials and storage permissions via the GroupDocs portal.

Do I need a license for production deployments?
A valid license is required for production. You can obtain a temporary license from the temporary license page while evaluating the SDK.

Read More

• Edit PowerPoint Presentations using Python
• Edit PowerPoint Files Using Java Library
• Best Practices for CSV Editor Development in Java

Combine Multiple Word Documents in Node.JS - Complete Code Example

This example demonstrates how to merge three DOCX files into a single document using the GroupDocs.Merger Cloud SDK for Node.js.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update the file paths (input1.docx, combined_output.docx, etc.) to match your actual file locations, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Merging Word Documents via REST API Using cURL

If you prefer a pure REST approach, the same merge operation can be performed with cURL commands. Below is a concise workflow that authenticates, uploads source files, runs the merge, and downloads the result.

1. Authenticate and Get Access Token

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

The response contains an access_token used in subsequent calls.

2. Upload the Source Files

Repeat this step for each DOCX file you want to merge.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. Execute the Merge Operation

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

The API returns the path of the merged file.

4. Download the Merged Document

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

For more details on request payloads and options, see the official API documentation.

How Merge Multiple Word Documents in Node.JS Works

The SDK abstracts the merge process into a few logical steps:

1. Configuration Creation - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) builds the authentication context. See the class reference in the API Reference.

   const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
   

2. API Instance - new GroupDocsMergerCloud.MergeApi(config) provides access to merge operations.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Document Entries - Each source file is wrapped in a DocumentEntry that contains a FileInfo with the file path.

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. Merge Request - MergeDocumentsRequest bundles the entries and the desired output path.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. Execution - mergeApi.mergeDocuments(mergeRequest) sends the request to the cloud service. The promise resolves with a result object containing the output file path.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

These steps together enable you to combine multiple Word documents efficiently without handling low‑level file streams.

Getting the Environment Ready for GroupDocs.Merger

1. Install the SDK

   npm install groupdocs-merger-cloud
   

   The package is available from the official download page.

2. Node.js Version - Ensure you are running Node.js 12 or later.

3. Configure Credentials - Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET in the code with the values from your GroupDocs Cloud account.

4. Create a Project Folder - Place the source DOCX files in a documents/ subfolder as shown in the example.

With these steps completed, you are ready to run the merge script or invoke the REST endpoints.

Conclusion

Combining multiple Word documents in Node.JS becomes straightforward with the GroupDocs.Merger Cloud SDK for Node.js. The SDK handles file uploads, merging logic, and output generation, allowing you to focus on business logic rather than low‑level file manipulation. Remember to secure a proper license for production use; you can start with a temporary license and upgrade to a full subscription as your needs grow. Start merging today and streamline your document workflows.

FAQs

• How do I combine multiple Word documents in Node.JS using the SDK?
  Use the MergeApi class to create a MergeDocumentsRequest that lists each DOCX file as a DocumentEntry. The SDK merges them in the order provided and saves the result to the specified output path.

• Is it possible to merge PDFs together with the same SDK?
  Yes, the Merger SDK supports PDF, DOCX, ODT, and several other formats. Simply change the file extensions in the inputFiles array and the SDK will handle the conversion automatically. See the official documentation for format details.

• What are the limits on the number of documents I can merge in a single request?
  The cloud service imposes a size limit rather than a strict count. As long as the combined size stays within your account’s quota, you can merge dozens of files. For very large batches, consider uploading files to GroupDocs storage first and referencing them by ID.

• Do I need to worry about licensing for development versus production?
  Development and testing can use a temporary license obtained from the temporary license page. For production deployments, purchase a full license to unlock unlimited merges and priority support.

Read More

• Password-Protect ZIP File using Password Protection Software
• Password-Protect Excel using Password Protection Service
• Combine Word Documents in C#