Licensing and evaluation Leave feedback

To help you quickly explore library and its features, GroupDocs.Viewer provides a Free Trial and a 30-day Temporary License for evaluation, as well as various purchase plans.

Sometimes, to get familiar with the system quickly, you may want to dive into the code right away. To make this easier, GroupDocs.Viewer offers a Free Trial and a 30-day Temporary License for evaluation, along with various purchase plans.

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.Viewer 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 three pages are processed.
• Documents with more than three pages are not supported.
• A trial watermark is placed at the top of each page.

If you’d like to test GroupDocs.Viewer 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.Viewer 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.Viewer will then read this value and apply the license.

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.Viewer can also read a license from the project’s root directory. Consider a simple Python app structure:

📂 my-app
 ├──app.py
 ├──source.docx
 ├──groupdocs-viewer-net-25.12-py3-none-*.whl
 └──GroupDocs.Viewer.lic

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

The following code demonstrates setting a license from a file:

import os
from groupdocs.viewer import License

def set_license_from_file():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Viewer.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.viewer import License

def set_license_from_stream():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Viewer.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 steam
    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.viewer 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 a number of MBs processed 
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

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

if __name__ == "__main__":
    set_metered_license()