Split Word Document using Python

In a collaborative environment, many people work collectively on a single document, and from time to time, they need to provide their input. However, once the document has grown to a significant size, it gets difficult to print the complete document or send it as an attachment with email. Therefore, we may have a requirement to split the document into small size documents. In this article, we are going to discuss the details on how to Split word documents using Python SDK.

Word Processing API

Aspose.Words Cloud is our dedicated solution for MS Word (DOCX, DOC, DOT, RTF, DOCM) or OpenDocument (ODT, OTT) processing. No third-party software or MS Office automation is necessary to process Word documents. Simply call the REST APIs to accomplish your requirements. Since the APIs are REST-based, so you can access them on any platform including Desktop, Web, Mobile App, etc.

In order to further facilitate our customers, we have created Aspose.Words Cloud SDK for Python, which is a wrapper around Cloud API, so you can take all the benefits of Word document processing within your favorite programming language. So before proceeding further, the first step is the installation of SDK on the local system. It is available for download at PIP and GitHub. Execute the following command on the command line terminal to install the SDK:

pip install aspose-words-cloud

In case you are using Visual Studio as IDE, you may directly add the reference of SDK in the project.

Click View -> Other Windows -> Python Environments option. As shown below

Python Environment menu option.
Image 1:- Python Environment menu option.

Enter aspose-word-cloud under Packages field in Python Environments window. Then click the Install aspose-word-cloud (21.11.0) link. The version number may change depending upon the latest/current release version. See the image below.

aspose-words-cloud python package
Image 2:- aspose-words-cloud python package.

Split all Pages of Word Document

Please follow the instructions below to split a word document already available in Cloud storage.

  • First, we need to initialize an object of WordsApi while passing Client ID and Client Secret details as arguments
  • Secondly, specify the name of input Word file, resultant output format, name of resultant file, and parameter to zip archive output
  • Upload input Word document using UploadFileRequest object
  • Now create an instance of SplitDocumentRequest while passing details defined in second step
  • Finally, call the split_document(…) method of WordsApi to perform the conversion operation. The resultant files are saved in mapped cloud storage
Preview of Document Split operation
Image 3:- Preview of Document Split operation.

Split Selected Pages of Word Document

In this section, we are going to discuss the details on how to split selected pages of the document and save the output as a ZIP archive. The code snippet is almost the same as shared above except we need to specify the Page From, Page To and True value for output to be archived.

Document Split output
Image 4:- Preview of Document Split operation for selected pages.

Use cURL Command to Split Word Document

Like other REST APIs, Aspose.Words Cloud can also be accessed via cURL commands within the command line terminal. However, before proceeding further, we need to first generate a JWT access token based on Client credentials.

curl -v "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Once the token has been generated, please execute the following command to split the selected page of the Word document and save the output in Cloud storage.

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/source.doc/split?format=DOCX&destFileName=Split-File&from=2&to=4&zipOutput=false" \
-H  "accept: application/json" \
-H  "Authorization: Bearer <JWT Token>"


In this article, we have explored the options of splitting Word documents into individual page documents. Based on your requirements, you may use the Python SDK or split the document using cURL commands. Please note that we believe in collective growth and collaboration. Therefore, our SDKs are developed as per MIT license and their complete source code is available for download over Github. If you need, you may download and modify the code as per your requirements. In case you encounter any issues or you have any further queries, please feel free to contact us via the Free product support forum.

Related Articles

We recommend you visit the following links to learn more about