October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

How to Set a Custom Page Size When CloudConvert Converts HTML to PDF

Use CloudConvert’s convert task for an HTML file, then retrieve the current HTML-to-PDF options before setting a custom PDF page size.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For an HTML file, use CloudConvert’s convert task with input_format: "html" and output_format: "pdf". Do not guess the custom page-size parameter: CloudConvert says conversion options vary by format pair, so retrieve the current HTML-to-PDF options in Job Builder or the Operations API and use the exact field name, value format, and units it reports.

First identify what you are converting

CloudConvert provides separate workflows for an HTML file and a live website URL. For a file, use the convert operation. For a website URL, CloudConvert documents a separate capture-website operation with its own parameters. Website-capture examples do not establish the page-size syntax for converting an HTML file.

As an Amazon Associate I earn from qualifying purchases.

  • HTML file: use convert, with HTML as the input format and PDF as the output format. See CloudConvert’s Convert Files documentation.
  • Live website: investigate capture-website and its own options. See Capture Website.

Find the current HTML-to-PDF page-size option

The exact option name, accepted value format, and units for custom page size depend on the selected conversion operation and engine. CloudConvert’s available documentation does not establish those details for HTML-to-PDF, so a field name or sample dimensions should not be assumed.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Open CloudConvert’s Job Builder, or query the Operations API.
  2. Select the convert operation with input format html and output format pdf, using the engine and version intended for your job.
  3. Inspect the returned options and details. Confirm the page-size option’s exact name, data type, units, allowed values, and whether custom width and height must be supplied together.
  4. Put that option and its documented value in the convert task. Do not copy the schematic placeholder below as a literal request.
  5. Run a conversion with the intended HTML and verify the resulting PDF’s page dimensions in a PDF viewer or your downstream workflow.

The CloudConvert Convert Files documentation states that “The available parameters differ based on input_format and output_format.” Use the options for the exact format pair rather than borrowing a setting from another conversion.

#1 Best Overall
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
  • Convert your PDF files into Word, Excel & Co. the easy way
  • Convert scanned documents thanks to our new 2022 OCR technology
  • Adjustable conversion settings
  • No subscription! Lifetime license!
  • Compatible with Windows 11, 10, 8.1, 7 - Internet connection required

Build the job around the convert task

A typical job imports the HTML, converts it, and exports the PDF. CloudConvert’s Quickstart Guide describes this task pattern and notes that conversion parameters vary by input and output format. The following is schematic; replace the bracketed option and value only after checking the current HTML-to-PDF options for your selected engine.

{
  "tasks": {
    "import-html": {
      "operation": "import/url",
      "url": "https://example.test/document.html"
    },
    "convert-html-to-pdf": {
      "operation": "convert",
      "input": "import-html",
      "input_format": "html",
      "output_format": "pdf",
      "<option-name-from-current-html-to-pdf-options>": "<documented-value>"
    },
    "export-pdf": {
      "operation": "export/url",
      "input": "convert-html-to-pdf"
    }
  }
}

This example demonstrates task relationships, not a tested request or a guarantee that importing from a URL suits every source. Use the import method appropriate to where your HTML is stored, and follow CloudConvert’s current API requirements for job submission and authentication.

Rank #2
DeskFX Free Audio Effects & Audio Enhancer Software [PC Download]
  • Transform audio playing via your speakers and headphones
  • Improve sound quality by adjusting it with effects
  • Take control over the sound playing through audio hardware

Why website-capture settings are not a substitute

The capture-website operation accepts a website URL and can produce PDFs or screenshots. Its documented controls include margins and optional header/footer templates. Those settings belong to website capture; they do not prove which custom page-size option is accepted by the HTML-file convert operation. Choose the operation based on the source you actually have, then inspect that operation’s options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot page-size problems

  • The API rejects the parameter: confirm the option name and type in the current options for convert with HTML input and PDF output. A setting from website capture or a different format pair may not be valid.
  • The job succeeds but the page dimensions are wrong: check the documented units and value shape, and confirm whether width and height must be supplied together. Then inspect the produced PDF’s dimensions rather than relying only on a successful job status.
  • You are starting from a website URL: decide whether you need to capture a live page or convert an HTML file. These are different operations, and their parameters are not interchangeable.
  • An example you found uses a different engine or version: retrieve the options for the engine and version you plan to run; available parameters may differ.

Or skip the browser setup

If what you need is a screenshot of a web page rather than a custom-sized PDF from an HTML file, ScreenshotNeo offers a one-request screenshot API. It accepts cookie and consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, with response headers identifying the page verdict and billing status. Its MCP server gives AI agents tools for screenshots, page information, and PDF capture.

For a screenshot, the basic call is:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

See the ScreenshotNeo API documentation for request options. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.

Rank #3
Data Recovery Stick for Windows Data Recovery Software – Photos, Files
  • The Data Recovery Stick requires no technical skills — simply plug it into your Windows computer, click Start, and the software automatically begins scanning and recovering lost files within minutes. Compatible with Windows Vista, 7, 8, 10, & 11, it's designed to be a reliable first step when accidental deletion occurs.
  • Recover photos (JPG, BMP, PNG, TIFF), Microsoft Office documents (Word, Excel, PowerPoint, Publisher, Access), Open Office files, MP3 music files, PDFs, RTF documents, AutoCAD files, and HTML web pages. Whether it's personal memories or critical business files, the Data Recovery Stick covers the file types that matter most.
  • Works with hard drives, USB drives, SD cards, memory sticks, and other common storage formats that use FAT or NTFS file systems — making it a single solution for hard drive recovery, USB drive recovery, SD card recovery, and more. Note: a media reader is required for micro SD cards and some mass storage devices.
  • No Installation Required - The Data Recovery Stick runs entirely from the USB drive with no software installation on your computer — helping prevent new data from overwriting the files you're trying to recover. This also makes it ideal for use across multiple computers or in emergency situations where installation isn't practical.
  • Use the Data Recovery Stick on as many computers as often as needed — simply clear the recovered data between uses to free up storage space. Software updates keep the tool compatible with newer systems and devices, backed by 25+ years of data software expertise from Paraben Consumer Software.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Frequently Asked Questions

Does the schematic JSON contain a usable page-size parameter?

No. Its option name and value are placeholders; use the current HTML-to-PDF options returned by CloudConvert for your selected engine.

Can I use the page-size settings shown for website capture on an HTML file?

Not without confirming them for the file-conversion operation. CloudConvert documents website capture and file conversion separately, with operation-specific parameters.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

Bestseller No. 1
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
PDF Converter Ultimate - Convert PDF files into Word, Excel, PowerPoint and others - PDF converter software with OCR recognition compatible with Windows 11 / 10 / 8.1 / 8 / 7
Convert your PDF files into Word, Excel & Co. the easy way; Convert scanned documents thanks to our new 2022 OCR technology
Bestseller No. 2
DeskFX Free Audio Effects & Audio Enhancer Software [PC Download]
DeskFX Free Audio Effects & Audio Enhancer Software [PC Download]
Transform audio playing via your speakers and headphones; Improve sound quality by adjusting it with effects
Bestseller No. 4
Convert to PDF
Convert to PDF
Export or Convert Text, HTML, PNG, JPG, or Camera Pictures to PDFs; Unlimited use; No ads; No personal data taken
$4.99
Bestseller No. 5
MixPad Multitrack Recording Software for Sound Mixing and Music Production Free [Mac Download]
MixPad Multitrack Recording Software for Sound Mixing and Music Production Free [Mac Download]
Mix an audio, music and voice tracks; Record single or multiple tracks simultaneously; Intuitive tools to split, trim, join, and many other editing features
Best Value
MixPad Multitrack Recording Software for Sound Mixing and Music Production Free [Mac Download]
  • Mix an audio, music and voice tracks
  • Record single or multiple tracks simultaneously
  • Intuitive tools to split, trim, join, and many other editing features
  • Loaded with audio effects including EQ, compression, reverb, and more.
  • Load an audio file and export to all popular audio formats from studio quality wav to high compression formats
Rank #4
Convert to PDF
  • Export or Convert Text, HTML, PNG, JPG, or Camera Pictures to PDFs
  • Unlimited use
  • No ads
  • No personal data taken
  • GDPR compliant

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.