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

Java Cloud SDK to Process Word® Documents in the Cloud


Product Page | Documentation | Live Demo | Swagger UI | Code Samples | Blog | Free Support | Free Trial

Aspose.Words Cloud SDK for Java helps you work with Word® & OpenOffice document formats within your cloud-based Java Apps, without installing any 3rd party software. It is a wrapper around Aspose.Words Cloud REST APIs.

Cloud Word® Document Processing Feature

  • Add and update document form fields.
  • Reset fonts cache.
  • Insert and update lists within Word® documents.
  • Generate reports based on data sources, such as JSON.
  • Create and configure various table elements (row, column, border, properties).
  • Add, update or delete document footnotes, hyperlinks, page numbers, paragraphs, & ranges.
  • Get or remove OfficeMath objects from documents.
  • Import and export documents in; DOC, DOCX, PDF, RTF, DOT, DOTX, ODT, OTT, HTML, MHTML, XML, & TXT.
  • Automatically detect the document type and assign correct classification (document, text) category to it.
  • Add, update, & delete document comments.
  • Keep track of changes within the document content (text additions, deletions and format modifications).
  • Insert, update or delete custom XML parts within the document.
  • Built-in PDF to Word file format conversion engine that correctly converts formatting, images, tables, & vectors.

Read & Write Cloud Document Formats

Microsoft Word®: DOC, DOCX, DOCM, DOT, DOTX, DOTM, FlatOpc, FlatOpcMacroEnabled, FlatOpcTemplate, FlatOpcTemplateMacroEnabled, WordML, RTF
OpenOffice®: ODT, OTT
Text: TXT
Fixed Layout: PDF
Markdown: MD

Save Cloud Document As

Fixed Layout: XPS
Vector: SVG, EMF
eBook: EPUB
PostScript: PS
Printer Control Language: PCL
Other: XamlFixed, XamlFlow, XamlFlowPack, HtmlFixed, OpenXPS

Read Document Formats

Microsoft Word®: DocPreWord60
eBooks: MOBI, CHM


Building the API client library requires:

  1. Java 1.7+
  2. Maven
  3. References Packages


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


Install from Maven

Add Aspose Cloud repository to your application pom.xml

        <name>Aspose Java API</name>

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/aspose-words-cloud-22.5.0.jar
  • target/lib/*.jar

Get Started

        // Start README example

        // if baseUrl is null, WordsApi uses default https://api.aspose.cloud 
        WordsApi wordsApi = new WordsApi(clientId, clientSecret, baseUrl);

        String localPath = PathUtil.get(localFolder, fileName);
        String remotePath = PathUtil.get(remoteFolder, remoteName);

        UploadFileRequest uploadRequest = new UploadFileRequest(Files.readAllBytes(Paths.get(localPath)), remotePath, null);

        DeleteWatermarkRequest request = new DeleteWatermarkRequest(remoteName, remoteFolder, null, null, null, null, null, null);
        //DocumentResponse result = wordsApi.deleteWatermark(request);

        // End README example


All Aspose.Words Cloud SDKs, helper scripts and templates are licensed under MIT License.

Authorization & Authentication

Authentication schemes defined for the API is as follows:



It’s recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Product Page | Documentation | Live Demo | Swagger UI | Code Samples | Blog | Free Support | Free Trial

VersionRelease Date
23.2.0February 13, 2023
23.1.0January 27, 2023
22.12.0December 9, 2022
22.11.0November 16, 2022
22.10.0October 17, 2022
22.9.0September 8, 2022
22.8.0August 12, 2022
22.7.0July 14, 2022
22.6.0June 16, 2022
22.5.0May 18, 2022
22.4.0April 14, 2022
22.3.0March 5, 2022
22.2.0February 15, 2022
22.1.0January 19, 2022
21.12.0December 8, 2021
21.11.0November 12, 2021
21.10.0October 19, 2021
21.9.0September 16, 2021
21.8.0August 27, 2021
21.7.0August 5, 2021
21.6.0July 1, 2021
21.5.0May 21, 2021
21.4.0April 16, 2021
21.3.0March 12, 2021
21.2.0February 11, 2021
21.1.0January 18, 2021
20.11.0November 19, 2020
20.10.0October 20, 2020
20.9.0September 4, 2020
20.8.0August 6, 2020
20.7.0July 6, 2020
20.6.0June 18, 2020
20.5.0May 15, 2020
1.0.0May 12, 2020
1.0.1May 12, 2020
1.0.3May 12, 2020
1.0.4May 12, 2020
1.0.5May 12, 2020
1.0.7May 12, 2020
1.0.8May 12, 2020
20.4.0April 8, 2020
20.3.0March 19, 2020
20.1.0January 22, 2020
19.12.0December 28, 2019
19.10.0November 20, 2019
19.2.0March 11, 2019
18.9.0October 8, 2018
18.8.0September 17, 2018