Convert HTML to JPEG in Python

To convert HTML to JPEG in Python, call Converter.convert_html() with an HTML source, ImageSaveOptions initialized for JPEG, and an output path. The source can be an HTML file, an HTMLDocument, inline HTML with a base URI, or a webpage URL supported by the selected overload.

JPEG and JPG are names for the same lossy image format. JPEG is widely supported and can produce smaller files than PNG, making it useful for webpage previews, reports, and content dominated by photographs. It does not support transparency and may introduce compression artifacts around small text and sharp edges.

Convert HTML to JPEG – Python Example

The basic workflow explicitly selects JPEG because PNG is the default format of ImageSaveOptions:

1. Load or specify the source HTML file.
2. Create ImageSaveOptions with ImageFormat.JPEG.
3. Call Converter.convert_html() with the source, options, and output JPEG path.

# Convert HTML to JPEG in Python

import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.rendering.image as rim

# Load the HTML document
with ah.HTMLDocument("document.html") as document:

    # Configure JPEG output
    options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)

    # Convert HTML to JPEG
    conv.Converter.convert_html(document, options, "output.jpeg")

The example loads document.html, selects JPEG output, and writes output.jpeg.

Convert a Webpage URL to JPEG in Python

Use a Url object to render an online HTML page as JPEG:

1. Create a Url object for the webpage.
2. Create JPEG save options and specify an output path.
3. Pass the URL, options, and output path to Converter.convert_html().

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.rendering.image as rim
import aspose.html.saving as sav

output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

url = ah.Url("https://docs.aspose.com/html/files/aspose.html")
output_path = os.path.join(output_dir, "aspose-from-url.jpg")

options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)
conv.Converter.convert_html(url, options, output_path)

The application must have network access to the page and its linked resources. A complex website can take longer to process while external resources are loaded.

Customize HTML to JPEG with ImageSaveOptions

Use ImageSaveOptions to control the page layout, background, CSS media type, antialiasing, and text hinting:

1. Load the HTML source into an HTMLDocument.
2. Create ImageSaveOptions for JPEG and configure the required rendering settings.
3. Convert the document and save the JPEG output.

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.drawing as dr
import aspose.html.rendering.image as rim
import aspose.html.saving as sav
import aspose.pydrawing as pd

input_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

input_path = os.path.join(input_dir, "document.html")
output_path = os.path.join(output_dir, "document-options.jpg")

with ah.HTMLDocument(input_path) as document:
    options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)
    options.page_setup.any_page = dr.Page(
        dr.Size(600, 500),
        dr.Margin(10, 10, 10, 10)
    )
    options.background_color = pd.Color.bisque
    options.use_antialiasing = True
    options.text.use_hinting = True
    options.css.media_type = options.css.media_type.SCREEN

    conv.Converter.convert_html(document, options, output_path)

The example creates a 600 × 500 pixel page with 10-pixel margins, uses a solid background because JPEG has no alpha channel, and explicitly applies screen-media CSS. Antialiasing is enabled by default; the assignment makes the selected rendering behavior visible in the example.

Control JPEG Dimensions, Background, and Sharpness

JPEG is suitable for photographs and continuous-tone images, but its lossy compression can soften text and sharp edges. ImageSaveOptions does not expose a separate JPEG compression-quality property.

• Set page_setup.any_page.size in pixels when exact JPEG dimensions are required.
• Set a solid background_color because JPEG cannot store transparency.
• Use sufficiently detailed source images. Increasing the output size cannot restore missing source detail.
• Keep antialiasing enabled and test text hinting for small text, while allowing for JPEG compression artifacts around sharp edges.

For shared page, resolution, CSS, and rasterization settings, see Configure Image Output with ImageSaveOptions.

Common HTML to JPEG Conversion Issues

Problem	Check or fix
The output has an unexpected background	JPEG cannot store transparency. Set background_color explicitly.
Text or sharp edges look blurred	Increase the actual output pixel dimensions, keep antialiasing enabled, and test font hinting. JPEG compression may still soften sharp edges.
A JPEG quality setting cannot be found	ImageSaveOptions does not provide a separate JPEG compression-quality property. Its compression property is for TIFF output.

For pagination, page sizing, missing resources, and URL-loading problems, see Common HTML to Image Conversion Issues.

Related HTML Conversion Guides

• HTML Converter – choose another HTML output format.
• Convert HTML to Image – compare raster formats and configure shared image settings.
• Convert HTML to PNG – use lossless output with transparency and sharper text or graphics.
• Convert HTML to GIF – convert HTML content to GIF output.
• Fine-Tuning Converters – compare direct conversion with renderer and device-based workflows.
• Rendering Options – configure image rendering with device-based APIs.

Other Platforms

• Convert HTML to JPG in .NET
• Convert HTML to Image in Java

FAQ

Are JPG and JPEG the same format?

Yes. .jpg and .jpeg are file extensions for the same JPEG image format. Use ImageFormat.JPEG with either extension.

Can I set JPEG compression quality with ImageSaveOptions?

No separate JPEG compression-quality property is exposed by ImageSaveOptions. Configure the rendered dimensions, antialiasing, text hinting, background, fonts, and source images to control the visible result.

Can I convert an HTML string to JPEG?

Yes. Use the Converter.convert_html() overload that accepts the HTML string, a base URI, JPEG save options, and an output path. The base URI is required when the string contains relative resource URLs.

Can I convert HTML to JPEG for free?

Use the free online HTML to JPG Converter below for occasional manual conversions. For programmatic conversion, you can evaluate the library without a license or follow the licensing guide to request a temporary license.

Try Online HTML to JPG Conversion

Use the free online HTML to JPG Converter for quick manual conversion without writing code. Use Aspose.HTML for Python via .NET when HTML-to-JPEG conversion must run in a Python application, service, or document-processing workflow.