Licensing and Subscription Leave feedback

GroupDocs.Merger offers a Free Trial and a 30-day Temporary License for evaluation, along with several purchase plans. If you want to dive straight into the code, the Free Trial is fully functional (see the limitations below) and does not require any setup.

Note

Please note that general policies and practices guide you on evaluating, licensing, and purchasing our products. See the Purchase Policies and FAQ section for details.

You can try GroupDocs.Merger without purchasing a license.

The evaluation version is identical to the full version — it simply becomes fully licensed when you apply a license. Instructions for setting a license are provided in the following sections.

The evaluation version has the following limitations:

• Only the first few pages of each document are processed (a page/document-count cap applies).
• Output carries an evaluation watermark — PDF output is watermarked, and other formats show an equivalent evaluation mark.

If you’d like to test GroupDocs.Merger without the limitations of the trial version, you can request a 30-day Temporary License. For more information, see the Get a Temporary License page.

Note

For information on pricing, visit the Pricing Information page.

Once you’ve obtained a license, follow these instructions to set it up.

A license should be set:

• Only once per application, and
• Before using any other GroupDocs.Merger classes.

Tip

Though the license can be set multiple times per application, it is recommended to set it only once, as repeated calls to the set_license method will use unnecessary processing time.

You can set the GROUPDOCS_LIC_PATH environment variable to the absolute path of the license file. GroupDocs.Merger will then read this value and apply the license automatically.

set GROUPDOCS_LIC_PATH "C:\path\to\your\license\file.lic"

$env:GROUPDOCS_LIC_PATH="C:\path\to\your\license\file.lic"

export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"

export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"

GroupDocs.Merger can also read a license from the project’s root directory. Consider a simple Python app structure:

📂 my-app
 ├──app.py
 ├──input.docx
 ├──groupdocs_merger_net-*.whl
 └──GroupDocs.Merger.lic

When you run the application from the my-app folder, GroupDocs.Merger will check for files with a .lic extension in this folder and read the GroupDocs.Merger.lic file to apply the license.

The following code demonstrates setting a license from a file:

import os
from groupdocs.merger import License

def set_license_from_file():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Merger.lic")

    # Check if license file exists
    if not os.path.exists(license_path):
        print(f"License file not found at: {license_path}")
        return

    # Instantiate License and set the license
    license = License()
    license.set_license(license_path)

if __name__ == "__main__":
    set_license_from_file()

This example shows how to set a license from a stream:

import os
from groupdocs.merger import License

def set_license_from_stream():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Merger.lic")

    # Check if license file exists
    if not os.path.exists(license_path):
        print(f"License file not found at: {license_path}")
        return

    # Create a readable stream
    with open(license_path, "rb") as license_stream:
        # Instantiate License and set the license
        license = License()
        license.set_license(license_stream)

if __name__ == "__main__":
    set_license_from_stream()

A Metered License is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage.

The following sample demonstrates how to use metered licensing:

from groupdocs.merger import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******"
    private_key = "******"

    # Check if keys are set
    if not public_key or public_key == "******" or not private_key or private_key == "******":
        print("Please set your public and private keys")
        return

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get the amount of data processed
    quantity = metered.get_consumption_quantity()
    print("Quantity consumed: ", quantity)

    # Get the number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()