compile(group: 'com.groupdocs', name: 'groupdocs-editor-cloud', version: '23.11')
<dependency org="com.groupdocs" name="groupdocs-editor-cloud" rev="23.11">
 <artifact name="groupdocs-editor-cloud" ext="jar"/>
libraryDependencies += "com.groupdocs" % "groupdocs-editor-cloud" % "23.11"

Document Editor Java Cloud REST API


Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial

GroupDocs.Editor Cloud SDK for Java helps you build cloud Document Editor Java Apps that work without installing any 3rd party software. It is a wrapper around GroupDocs.Editor Cloud REST APIs.

Cloud Document Editing SDK Features

  • Programmatically edit various types of documents and files in the cloud.
  • Various editing options are provided based on the file type, such as:
    • Word processing
      • Edit documents in the paged or pageless (flow) mode
      • Multi-language document editing
      • Extract font information to work with fonts to give same document appearance in various environments
    • Spreadsheets: Edit multi-tabbed worksheets.
    • Comma or Tab separated files (Delimiter Separated Values)
      • Specify value separator
      • Numeric conversion
      • Date conversion
      • Memory usage optimization to cater to large file processing
    • XML files
      • Resolve incorrect document structure
      • Recognize URIs & email addresses
      • Options to configure highlights & formatting
  • Cloud document information extraction facility to fetch info about the edited document.

Supported Document Editor Formats

Microsoft Word®: DOC, DOCX, DOCM, DOT, DOTM, DOTX, FlatOPC, RTF, WordML, TXT
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, XLAM, SpreadsheetML, DIF, DSV, CSV, TSV
OpenOffice Calc®: SXC, ODS, FODS
Microsoft PowerPoint®: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM
OpenOffice Impress®: ODP, OTP
Markup: HTML, XML


Building the API client library requires:

  1. Java 1.7+
  2. Maven


To use GroupDocs.Editor Cloud SDK for Java you need to register an account with GroupDocs Cloud and lookup/create Client ID and Client Secret at Cloud Dashboard. There is free quota available. For more details, see GroupDocs Cloud Pricing.

Install GroupDocs.Editor-Cloud from Maven

Add GroupDocs Cloud repository to your application pom.xml


Install from source

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project’s POM:



At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

  • target/groupdocs-editor-cloud-22.5.jar
  • target/lib/*.jar

Get Started

Please follow the Quick Start instructions.

Sample Java Code to edit a DOCX in the Cloud

/ For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-java-samples
String MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);

// Create necessary API instances
EditApi editApi = new EditApi(configuration);
FileApi fileApi = new FileApi(configuration);

// The document already uploaded into the storage.
// Load it into editable state
FileInfo fileInfo = new FileInfo();
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
LoadResult loadResult = editApi.load(new LoadRequest(loadOptions));

// Download html document
File file = fileApi.downloadFile(new DownloadFileRequest(loadResult.getHtmlPath(), null, null));

// Edit something...
List<String> lines = Files.readAllLines(file.toPath());
List<String> newLines = new ArrayList<String>();
for (String line : lines) {
    newLines.add(line.replaceAll("Sample test text", "Hello world"));
Files.write(file.toPath(), newLines);

// Upload html back to storage
fileApi.uploadFile(new UploadFileRequest(loadResult.getHtmlPath(), file, Common.MYStorage));

// Save html back to docx
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions();
DocumentResult saveResult = editApi.save(new SaveRequest(saveOptions));

System.out.println("Document edited: " + saveResult.getPath());

Authorization & Authentication

Authentication schemes defined for the API is as follows:


Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial

VersionRelease Date
23.11November 23, 2023
23.5May 23, 2023
22.5May 25, 2022
19.11January 25, 2022
21.7January 25, 2022